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top-down  approach.  Starting  with  a system  level  description  in  the  first 
section,  each  subsequent  section  describes  a subset  of  the  total  system 
in  detail. 
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LIST  OF  JAVS  REPORTS 


• JAVS  Technical  Report:  Vol.  1,  User's  Guide.  This  report  is  an  intro- 
duction to  using  JAVS  in  the  testing  process.  Its  primary  purpose  is  to  acquaint 
the  user  with  the  innate  potential  of  JAVS  to  aid  in  the  program  testing  pro- 
cess so  that  an  efficient  approach  to  program  verification  can  be  undertaken. 

Only  the  basic  principles  by  which  JAVS  provides  this  assistance  are  discussed. 
These  give  the  user  a level  of  understanding  necessary  to  see  the  utility  of 

the  system.  The  material  on  JAVS  processing  in  the  report  is  presented  in  the 
order  normally  followed  by  the  beginning  JAVS  user.  Adequate  testing  can  be 
achieved  using  JAVS  macro  commands  and  the  job  streams  presented  in  this  guide. 
The  Appendices  include  a summary  of  all  JAVS  commands  and  a description  of  JAVS 
operation  at  RADC  with  both  sample  command  sets  and  sample  job  control  state- 
ments . 

• JAVS  Technical  Report:  Vcl.  2,  Reference  Manual.  This  report  describes 

in  detail  JAVS  processing  and  each  of  the  JAVS  commands.  The  Reference  Manual 
is  intended  to  be  used  along  with  the  User's  Guide  which  contains  the  machine- 
dependent  information  such  as  job  control  cards  and  file  allocation.  Througi  - 
out  the  Reference  Manual,  modules  from  a sample  JOVIAL  program  are  used  in 
the  examples.  Each  JAVS  command  is  explained  in  detail,  and  a sample  of  each 
report  produced  by  JAVS  is  included  with  the  appropriate  command.  The  report 
is  organized  into  two  major  parts:  one  describing  the  JAVS  system  and  the 

other  containing  the  description  of  each  JAVS  command  in  alphabetical  order. 

The  Appendices  include  a complete  listing  of  all  error  messages  directly 
produced  by  JAVS  processing. 

• JAVS  Technical  Report:  Vol.  3,  Methodology  Report.  This  report  describes 

the  methodology  which  underlies  and  is  supported  by  JAVS.  The  methodologv  is 
tailored  to  be  largely  independent  of  implementation  and  language.  The  dis- 
cussion in  the  text  is  intended  to  be  intuitive  and  demonstrative.  Some 

of  the  methodologv  is  based  upon  the  experience  of  using  JAVS  to  test  a large 
information  management  system.  A long-term  growth  path  for  automated  verifi- 
cation systems  that  supports  the  methodology  is  described. 

• JAVS  Computer  Program.  Documentation:  Vol.  1,  System.  Design  and  Imp  1 ere  ro- 
tation . This  report  contains  a description  of  JAVS  software  design,  the  organi- 
zation and  contents  of  the  JAVS  data  base,  and  a description  of  the  software 
for  each  JAVS  component:  its  function,  each  of  the  modules  in  the  component, 
and  the  global  data  structures  used  by  the  component.  The  report  is  intended 
primarily  as  an  informal  reference  for  use  in  JAVS  software  maintenance  as  a 
companion  to  the  Software  Analysis  reports  described  below.  Included  in  the 
appendices  are  the  templates  for  probe  code  inserted  by  instrumentation  pro- 
cessing for  both  structural  and  directive  instrumentation  and  an  alphabetical 
list  of  all  modules  in  the  system  (including  system  routines)  with  the  formal 
parameters  and  data  type  of  each  parameter. 

• JAVS  Computer  Program  Documentation:  Vol.  2,  Software  Analysis.  This 
volume  is  a collection  of  computer  output  produced  by  JAVS  standard  processing 
steps.  The  source  for  each  component  of  the  JAVS  software  has  been  analyzed 
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to  produce  enhanced  source  listings  of  JAVS  with  indentation  and  control  struc- 
ture identification,  inter-module  dependence,  all  module  invocations  with  formal 
and  actual  parameters,  module  control  structure,  a cross  reference  of  symbol 
usage,  tree  report  for  each  leading  module,  and  report  shewing  sice  of  each 
component.  It  is  intended  to  be  used  with  the  System  Design  and  Implementation 
Manual  for  JAVS  software  maintenance.  The  Software  Analysis  reports,  on  file 
at  RADC,  are  an  excellent  example  of  the  use  of  JAVS  for  computer  software 
documentation. 

• JAVS  Preprocessor  for  JOVIAL.  This  report,  prepared  for  GRC  by  its  sub- 
contractor, System  Development  Corporation  (SDC) , describes  the  software  for 
the  JAV'S-2  component:  its  origin  as  the  GEM1  part  of  the  SAM-D  ED  Compiler, 
the  modifications  made  in  GEN1  to  adapt  the  code  for  JAVS-2,  the  JAVS-2  code 
modules,  and  the  data  structures.  It  contains  excerpts  of  other  SDC  reports 
on  the  SAM-D  ED  JOVIAL  Compiler  System.  The  report  reflects  the  status  of  the 
software  for  JAVS-2  as  delivered  by  SDC  to  GRC  in  September  1974.  The  de- 
scription of  JAVS-2  software  contained  in  the  System  Design  and  Integration 
report  reflects  the  status  of  JAVS-2  as  delivered  to  RADC  by  GRC  in  September 
1975  and  thereby  supercedes  the  SDC  report. 

• JAVS  Final  Report.  The  final  report  for  the  project  describes  the  im- 
plementation and  application  of  a methodology  for  systematically  and  comprehen- 
sively testing  computing  software.  The  methodology  utilizes  the  structure  of 
the  software  undergoing  test  as  the  basis  for  anlaysis  by  an  automated  verifi- 
cation system  (AVS).  The  report  also  evaluates  JAVS  as  a tool  for  software 
development  and  testing. 
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INTRODUCTION 


JAVS  is  a system  of  compatible  tools  intended  to  be  applied  during 
program  testing  to  aid  in  the  recognition  of  untested  program  paths,  to 
assist  in  the  development  of  additional  testcases  appropriate  to  improvement 
of  testing  coverage,  and  to  automatically  document  the  computer  program. 
Program  validation  is  provided  by  analysis  of  program  structures,  instrumenta- 
tion of  the  system  through  insertion  of  appropriate  software  probes  to  measure 
testing  coverage,  and  comprehensive  reports  which  pinpoint  paths  in  the  prog- 
ram structure  that  remain  to  be  exercised.  In  addition,  guidance  is  provided 
for  the  generation  of  testcases  that  will  assure  coverage  of  the  untested 
portions.  JAVS  can  be  thought  of  as  a partner  during  the  testing  process, 
supplying  a wide  variety  of  automated  aids  to  the  user  in  comprehensive  test- 
ing activities. 

This  Reference  Manual  is  intended  to  be  used  along  with  the  JAVS  User's 
Guided  and  describes  in  detail  JAVS  processing  and  each  of  the  available  JAVS 
commands . 

The  machine-dependent  features  are  described  in  the  JAVS  User's  Guide 
which  contains  a description  of  the  overlay  version  of  JAVS,  the  JAVS  macro 
commands,  examples  of  job  setups  for  RADC,  and  file  and  processing  time 
information. 


The  format  for  this  Reference  Manual  is  as  follows: 


Section  1:  JAVS  system  overview  and  organization,  library  and  file 

description,  data  management,  command  structure,  example 
test  program,  START-TERM  source  text  identification  and 
JAVS  computation  directives.  The  last  two  items  deal 
with  additions  the  user  makes  to  his  source  code  before 
JAVS  testing  begins. 


Section  2 
Section  3 
Section  4 
Section  5 


Description  and  diagram  of  each  processing  step. 
JAVS  constraints 

System  level  description  of  JAVS  commands 
Description  of  each  JAVS  command 
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1.1 


3RIEF  DESCRIPTION  OF  JAVS 


1.1.1  Processing  Steps 

, In  Che  standard  version,  JAVS  is  organized  as  a series  of  independent 

processing  steps,  each  devoted  to  a unique  task,  that  communicate  chrough  a 
common  data  base  to  provide  thorough  software  verification  assistance.  The 
overlay  version  of  JAVS  maintains  the  same  processing  tasks,  but  it  allows 
the  user  to  perform  multiple  processing  steps  in  a single  module  selection  or 
in  a single  activity.  The  various  steps  and  their  basic  functions  are  listed 
below: 


3ASIC,  Source  Text  Analysis:  Source  text  input,  lexical  analysis,  and 

initial  source  library  creation 

STRUCTURAL , Structural  Analysis:  Structural  analysis  and  execution  path 

identification;  library  update  with  structure  and  path  information 

INSTRUMENT,  Module  Instrumentation : Program  instrumentation  for  path 

coverage  analysis  and  program  performance  directed  by  user;  library 
update  with  probe  test  instrumentation 

ASSIST,  Module  Testing  Assistance  and  Segment  Analysis:  Testing  assist- 

ance for  improved  program  coverage 

DEPENDENCE,  Retesting  Guidance  and  Analysis:  Retesting  requirements 

analysis  for  changed  modules 

Test  Execution:  Execution  of  instrumented  code  and  analysis  of  directed 

program  performance 

ANALYZER,  Test  Effectiveness  Measurement:  Detailed  analysis  of  program 

path  coverage;  execution  traces  and  summary  statistics 

These  steps  need  not  be  performed  in  the  above  order.  Other  orders  may  be 
preferable  at  times. 

An  overview  of  how  JAVS  is  used  in  the  testing  process  is  shown  in 
Fig.  1.1. 
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JOVIAL  source  code  Is  input  for  processing  and 
analysis.  A special  form  of  comment  (optional) 
inserted  by  the  user  directs  JAVS  processing  for 
program  performance  analysis. 

JAVS  analyzes  the  code  and  generates  a directed 
graph  of  the  control  structure. 

The  possible  flows  through  the  program  are 
determined.  All  pertinent  data  is  stored  in  a 
data  base  for  later  use.  Additional  or 
changed  source  code  causes  an  existing  data 
base  to  be  updated. 

JAVS  automatically  inserts  software  probes 
into  the  source  code  to  intercept  and  record 
program  flow  during  execution.  A second  type 
of  instrumentation  is  used  to  record  statistics 
on  program  performance  according  to  directives 
inserted  by  the  user  in  the  source. 

JAVS  provides  a variety  of  services  which  assist 
in  the  establishing  of  a continuing  testing  strat- 
egy both  at  the  detailed  level  within  a module  and 
at  the  module  interdependence  level.  Test  cases 
are  constructed  by  the  user.  Reports  can  be  used 
as  program  documentation. 

Program  execution  provides  normal  computational 
results  as  well  as  outputs  from  the  instrumen- 
tation. Structural  flow  output  is  recorded  for 
later  post-test  analysis  by  JAVS.  User-directed 
program  performance  output  is  interspersed  with 
normal  program  output. 

JAVS  includes  detailed  post-test  analysis 
facilities  which  provide  measures  of  testing 
thoroughness,  both  individually  and  cumula- 
tively for  a set  of  test  cases. 


The  results  are  examined  by  the  user  to  determine 
if  test  goals  have  been  met  and  testing  is 
completed. 
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1.1. 


Library  Definition  and  Contents 


JAVS  utilizes  a random-access  file  which  includes  the  original  source 
text,  as  veil  as  subsidiary  tables  that  contain  structural  information,  sym- 
bols and  their  classification,  and  other  module-descriptive  information.  The 
initial  random  library  is  created  during  the  first  processing  step  (3ASIC). 

The  second  step  (STRUCTURAL)  uses  the  initial  library  data  to  create  an  up- 
I . dated  library  containing  program  structure  data  as  veil  as  the  source  text. 

INSTRUMENTATION  adds  instrumented  text  to  the  library.  The  library  and  instru- 
mented file  are  then  used  as  input  for  other  analyses.  The  major  sections  of 
a completed  library  are  listed  below: 

Analyzed  source  text  (3ASIC) 

Module  descriptions  (3A3IC) 

Statement  descriptions  (3ASIC) 

Symbol  descriptions  (3ASIC) 

Program  structure  information  (STRUCTURAL) 

Probe  text  (INSTRUMENTATION) 

1.1.3  File  Identification 

JAVS  makes  use  of  various  files  during  execution  of  the  standard  and 
overlay  processing  steps.  The  files  used  in  JAVS  processing  are  shown  in 
Table  1.1. 

TABLE  1.1  FILES  USED  IN  JAVS  PROCESSING 


— 

Number 

Name 

Function 

Mode 

T vo  e 

Usage 

1 1 

— 

1 

LIBOLD 

Old  library 

3inary 

Random 

Read/write 

9 

LIBNEW 

New  library 

Binary 

Random 

Read /write 

3 

LIBWSP 

(Temporary)  workspace 

3inarv 

Random 

Read /write 

4 

COMAUX 

(Temporary)  command  itera- 
tion 

BCD 

Serial 

Read/write  ! 

i- 

i 

5 

1C0MMAN 

ICOMMAC* 

JAVS  command  input 

BCD 

•Serial 

Read  only 

6 

LOUT 

Standard  printer  output 

3CD 

Serial 

Write  only 

7 

LPUNCH 

Instrumented  source  text 

3CD 

Serial 

Write  only 

Li 

3 

AUDIT 

Test  execution  probe  data 

3CD 

Serial 

Read/write 

| 

9 

READER 

Source  text  input 

BCD 

Serial 

Read  only 

6 

10 

COMMAN* 

(Temporary)  JAVS  command 
•workspace 

BCD 

Serial 

Read/write 

* Used  only  in  JAVS  overlay  version. 
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1.1.4  System  Execution  Control 


JAVS  utilizes  a command  language  to  provide  control  over  many  of  the  pro- 
cessing steps.  The  command  language  provides  the  means  to  select  various  pro- 
cessing options  within  the  selected  step  and,  in  addition,  allows  the  user  to 
repeatedly  execute  certain  sequences  of  commands  for  sets  of  program  modules 
contained  within  the  library  file.  Certain  commands  are  available  for  use  in 
all  steps  and  are  therefore  termed  "universal  commands."  In  the  standard  ver- 
sion of  JAVS,  some  commands  are  unique  to  each  processing  step  and  are  recog- 
nized only  when  employed  within  that  step.  The  overlay  version  of  JAVS  allows 
commands  from  any  processing  step  to  be  utilized  in  a single  run. 


1.1.5  Data  Management 

Included  within  the  standard  processing  steps  is  a data  management  com- 
ponent which  provides  the  following  capabilities: 

1.  Library  merging 

2.  Processing  initialization  commands 

3.  Module  selection 

4.  Standard  printouts  of  library  contents 


y 
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1.2  COMMAND  STRUCTURE 


A JAVS  run  is  defined  by  a sec  of  commands.  These  commands — one  to  a 

card — are  freeform;  blanks  are  ignored.  The  card  scan  ends  with  a period  (.) 

or  with  the  end  of  Che  card.  Each  command  consists  of  a sequence  of  terms 
separated  by  a comma  or  an  equals  sign.  A term  with  an  initial  digit  is 
assumed  to  be  an  integer.  If  a command  must  be  continued  on  more  than  one 
card,  a comma  must  appear  as  the  last  non-blank  character  of  each  card  pre- 
ceding a continuation  card.  Up  to  three  continuation  cards  may  be  used. 

A JAVS  command  sec  always  begins  with  seme  library  commands  ending  with 
the  command  START*.  Next  comes  a set  of  action  and  information  commands  de- 
scribing what  processing  is  to  be  performed,  listing  which  modules  are  to  be 

used,  and  which  options  are  to  be  included.  A JAVS  run  terminates  on  the  END. 

command,  which  provides  for  correctly  closing  any  files  and  writing  a wrapup 
summary. 

The  commands  shown  in  Fig.  1.2  for  a hypothetical  JAVS  run  were  designed 
to  help  show  the  structure  and  use  of  JAVS  commands. 


i 

COMMAND 

TYPE 

OLD  LI3RARY  = 0LD1. 

Library  command 

CREATE  LIBRARY  = NEVI2. 

Library  command 

START. 

Startup  command 

FOR  LI3RARY. 

Module  selection  coronand 

STRUCTURAL. 

Execution  command 

END  FOR. 

Module  selection  command 

MODULE  = EXMPL1 . 

Module  selection  command 

PRINT, MODULE. 

Universal  print  command 

END. 

Run  termination  command 

Figure  1.2.  Hypothetical  Command  Sequence 


The  JAVS  macro  commands  contain  the  START  and  additional  commands.  The  macro 
commands  require  the  JAVS  overlay  version  and  are  described  in  the  JAVS  User's 
Guide , along  with  other  system  dependent  information. 
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1.3 


EXAMPLE  PROGRAM 


Throughout  this  Reference  Manual,  modules  from  a sample  JOVIAL  program 
are  used  in  the  examples.  Figure  1.3  shows  a complete  listing  of  the  sample 
program  with  its  five  modules:  COMPOOL  EXCOMPL,  PROGRAM  EXPROGM,  PROC  EXAMPL1, 
CLOSE  EXAMPL2  and  CLOSE  EXAMPL3.  These  modules  are  so  simple  that  they  do  not 
in  any  way  demonstrate  the  power  of  JAVS;  their  purpose  is  solely  to  provide 
simple  output  examples  for  each  of  the  commands.  The  output  from  the  execu- 
tion of  the  program  is  shown  in  Fig.  1.4.  This  output  is  generated  from  the 
MONITOR  statements  which  appear  in  the  main  program  EXPROGM. 

DEPENDENCE  processing  deals  primarily  with  inter-module  dependencies.  A 
program  with  a large  number  of  modules  is  used  as  an  example  to  illustrate  the 
power  of  inter-module  analysis  performed  by  JAVS.  STRUCTURAL  analysis  (Sec. 
2.2)  is  illustrated  using  an  example  procedure  from  the  JAVS  User's  Guide. 

This  small  module  is  used  to  demonstrate  the  identification  of  DD-paths. 


AA.JAVSTEXT  E XCOMPl  PRESFTaa 
START* 

AACOMPOOL  E * ample  CONTAINING  PRESET  output  MESSAGES  aa 
COMMON  ME  SAGE  * 

BEGIN 


ITEM 

MSG  1 

H 

IB 

P 

1«H(1JAVS  TEST 

CASE 

IS 

ITEM 

MSG? 

H 

18 

P 

1Bh(0RPSULt 

IT 

4 

1 s 

ITEM 

“SG3 

H 

IB 

P 

1 BH IPRESULT 

EQ 

A 

) s 

ITEM 

msga 

H 

18 

P 

1 BH (ORPSULT 

GT 

4 

1 s 

ITEM  MESSAG  M IB* 
END 
TE»M* 


AA.JAVSTEXT  EXPROGM  COMPUTE  (EXCOMPl)AA 
STARTS 

AAJOVlAL  SIMPLE  TEST  PROGRAM  aa 

DEFINE  INTG  a a I 2a  S a A S 

OFF INE  HLL  AA  M A A A S 

OEFINE  NR  Y T MO  AA  A A A S 

ITEM  id  HLLS 

ITEM  I TE P 1 INTGS 

ITEM  ITFR2  INTGS 

ITE“  ITERIA  hlL* 

ITEM  1 TER?A  HLL* 

OVERLAY  ITER]  = I TER  1 « * 
overlay  iter?  * iter?a* 

ITEM  CARD  H BPS 

FILE  READER  h p r Ba  V(OK)  V ( EOr I TtPE*« 
FILE  PR  INTR  M 0 R 1?«  V I OK ) viEOFl  T*PE*-« 
MONITOR  ID,  I TE  o 1 A , I TER2AS 
MESSAG  * MSGIS 
OUTPUT  PRINTW  MFSSAGS 
BG.  INPUT  READER  CAPOS 

if  reader  no  viEons 


Figure  1.3.  Example  Program  Used  in  the  Reference  Manual 

(Continued  on  next  page) 
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. t „ *X’  .v  * ..  . ' 

- . - ' . . MBA 


8EG  I N 

BYTE  ISO,  NBYTwOS)  (IT)  a 8 Y T*  ( SO  . Nfl  Y T aD  S I fCAUOlS 
BYTE < S3 .NBYTaOS)  (5TE9\»)s  by T£  i s8 . nb y t aDS I (CARO)S 
BYTE  I SO .NBYTaoS ) (irrajuis  BYTE  (SlR.NHYTaOSl  ICARRIS 
ExmPl 1 ( I TE»1 . i TF82 ) S 
CLOSE  EXMPL2S  •*  main  CLOSE  t* 

BEGIN 

ITE»1  » IS 
1TE02  a IS 
ENO  <*EImpl2** 

IF  ITER!  GO  100S 
GOTO  E*“pL?s 

GOTO  80S 
ENO  <*IF<< 

STOPS 

PROC  EXMPLl  (LIMIT)  »L I N l T 2 1 S 
BEGIN 

ITEM  LIMIT!  INTGS 
ITEM  L I M I T 2 INTGS 
ARRAY  FILL  100  INTGS 
ITEM  RESULT  INTGS 
ITEM  INQKS  INTGS 
**.  TRACE .RESULT** 

IF  LIMIT1  GO  100S 
LIMIT!  a 98S 

re Sul t a *s 

FOB  I a 1 , 1 . L I M I T 1 S 
BEGIN 

F*. EXPECT.  RESULTal  ,S*F 
FILL  ISI-1SI  = IS 
RESULT  = (RFSULT.il/IS 
XX .ASSERT  .RFSJLT  jB  10X* 

FOR  J a 1 , 1 ,LlMI T2S 
BEGIN 

CLOSE  EX“°L3S  t*  PROC  CLOSE  t* 

BEGIN 

RESULT  a 2«JS 
ENO  aaCLOSF  ** 

IFEITM  j lO  is 
INOXS  a Jj 
ORIF  IS 

INOXS  « *S 
ENO  XFIFEITm** 

switch  pic*  a ilareli .labeli .laheli .l4bel2is 
GOTO  Pics  (SINOXS-1SIS 
LABEL?.  GOTO  EXMPL3S 

LABEL  1 • IFEITH  RESULT  LS  *S 

MESS4G  a msgps 
ORIF  RESULT  EO  »S 
MESS4G  a MSQ3S 
ORIF  IS 

ME  SS  AG  a 
ENO  x*IFEITh<* 

OUTPUT  PRINTR  MgSSAGS 
END  ttjtt 
ENO  **\  XX 

XX,OFFTRACE.PESULTx* 

ENO  FFEXMPL!** 

TERM* 


Figure  1.3.  (Coatinued) 
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T-Ywiit^am 


I 


JAVS  TEST  CASE 


#«• 

MONITORED 

HOLLERITH 

OATA 

10 

■ 

TwO 

MON 1 TORE  0 

HOLLERITH 

DATA 

ITERiA 

9 

300 

••• 

MONITORED 

HOLLERITH 

OATA 

ITE«2A 

9 

1 99 

RESULT  GT  A 

• •• 

MONITORCO 

HOLLERITH 

DATA 

10 

■ 

ONE 

• •• 

MON  I TORE 0 

HOLLERITH 

DATA 

ITERIA 

» 

AG 

«•# 

MONI TOREO 

HOLLERITH 

OATA 

I T£  R?A 

• 

1A 

RESULT  GT  * 


Figure  1.4.  Output  from  Execution  of  Sample  Program 
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1.4 


TEXT  IDENTIFICATION 


JAV3  automatically  separates  a START-TERM  sequence  of  JOVIAL  source 
which  contains  executable  JOVIAL  statements  (i.e.,  not  a CCMPQOL)  into  nodules 
of  invokable  code  a.g.,  a PROC,  a ‘-LOSE).  Alter  the  source  code  has  been 
ins  tr -men tad , it  ts  reassembled  into  the  START-. ERM  sequence  in  preparation 
tor  c-mp  elation  and  east  execution.  If  tore  than  one  START-TERM  sequence  is 
'*crl ~ained  on  the  library,  it  is  necessary  tj  identity  each  sequence  separately 
with  a unique  none.  JAVS  has  provision  for  naming  a START-TERM  sequence  and 
distinguishing  between  types  of  text  through  the  use  of  a speciaL  fora  of 
consent  called  a JAVSTEXT  directive: 


JAVS  TEXT  < name  > < typ  e > ( ( < r e la  t ed-  c ex t- 


ist>) ] [<description>!" 


where 

<nane>  is  the  naae  given  to  the  START-TERM  sequence  (name 

must  be  3 or  less  characters,  in  which  the  first  6 
characters  must  be  unique  among  the  JAVSTEXT  names) 

<ty?e>  is  COMPUTE  for  an  executable  START-TERM  text  (e.g., 

a program)  or  PRESET  for  nonexecutable  text  (e.g., 
a CCMPOOL) 


<r elated- text- lis t> 


<description> 


is  an  optional  list  of  related  text  names  separated 
by  commas  (e.g.,  the  name  of  a CCMPOOL  text  used 
during  oompilation  with  a program  text) 

is  optional  descriptive  information 


The  JAVSTEXT  directive  should  ippear  immediately  before  the  ST.ART  for  a main 
program  or  for  a PROC  subprogram  (external  PROC).  in  the  case  of  CLOSE  sub- 
program (external  CLOSE),  the  JAVSTEXT  name  must  be  different  than  the  CLOSE 
name,  and  the  JAVSTEXT  directive  should  appear  before  the  CLOSE  statement. 

In  the  example  program,  the  JAVSTEXT  directive 

".JAVSTEXT  EXCOMPL  PRESET" 

is  used  to  inform  JAVS  that  a COMPOOL  is  being  processed.  The  JAVSTEXT  direc- 
tive 

".JAVSTEXT  EXPROGM  COMPUTE  (EXCOMPL)" 


is  used  to  inform  JAVS  that  an  executable  START— TERM  sequence  which  references 
a uOMPOOL  (cXCOMPL)  is  being  processed.  This  directive  is  required,  even  if 
tne  -OMPOOL  is  not  to  be  processed,  if  CCMPOOL  defined  names  are  referenced  in 
the  program  text.  Only  one  COMPOOL  may  be  put  in  the  database  library  for  each 
execution  of  the  3-v.iIC  step,  when  processing  Doth  COMPOOL  and  executable  text. 

If  a CGMP'-OL  is  to  be  processed  by  JAVS,  it  should  be  analyzed  only  by  the 
BAoIC  seep.  Tne  COMPOOL  will  then  be  available  on  the  library  for  documentation 
printing. 
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1.5  JAY’S  COMPUTATION  DIRECTIVES 


JAY'S  contains  facilities  for  analyzing  a special  form  of  JOVIAL  comment, 
called  the  JAY'S  directive.  There  are  two  types  of  JAVS  directives:  computation 
directives  and  text  identification  directives  (Sec.  1.4).  The  computation 
directives,  described  in  this  section,  are  intended  for  use  in  monitoring  com- 
putations performed  by  the  program. 

The  directives  are  inserted  by  the  user  in  the  JOY'IAL  source  before  it 
is  processed  by  BASIC.  They  are  stored  as  separate  statements  in  the  state- 
ment block  on  the  library  created  by  BASIC.  Later  INSTRUMENT  analyzes 
the  computation  directives  and  produces  probe  text  (under  option  MODE  = FULL/ 
DIRECTIVES)  which,  when  added  to  the  source  text,  generates  execution-time 
output  interspersed  with  normal  program,  output. 

There  are  four  JAY’S  computation  directives:  ASSERT,  EXPECT,  TRACE,  and 
OFFTRACE.  Each  directive  generates  JOY’IAL  text  which  becomes  part  of  the  probe 
text.  The  user  is  cautioned  that  BASIC  does  no  checking  for  errors  in  JAY’S 
directives.  Since  the  probe  text  is  ultimately  compiled,  it  must  be  error-free 


1.5.1  ASSERT  Directive 


The  ASSERT  directive  provides  the  user  with  a means  to  monitor  the  truth 
value  of  a particular  logical  condition.  The  format  of  the  ASSERT  directive 
is : 


" . AS SERI , <JOVlAL-boolean-expression>" 

The  ASSERT  directive  may  be  placed  wherever  it  is  legal  to  place  a simple  IF 
statement  followed  by  an  assignment  statement  in  the  executable  text.  During 
Test  Execution  of  a directive- instrumented  module,  a message  is  generated  if 
the  assertion  is  false. 

During  INSTRUMENT  the  ASSERT  directive  will  generate  the  following 

code : 


ITEM  JAY’S 'ASSERT  H 60  S 
MONITOR  JAY’S 'ASSERT  $ 

IF  NOT  <JOVIAL-boolean-expression>  $ 

JAVS 'ASSERT  = xxH(<JOY’IAL-boolean-expression>  AT  STMT, 
xxxx  NOT  TRUE . ) $ 

where  xx  is  determined  and  inserted  automatically.  If  the  <J0Y’IAL-boolean- 
expression>  is  longer  than  provided  for  in  monitor  output,  it  will  be  truncated 
The  statement  number  xxxx  is  computed  during  INSTRUMENTATION  to  be  the  state- 
ment number  assigned  by  JAY’S.  The  statement  numbers  are  located  in  the  PRINT, 
MODULE  and  PRINT,  JAVSTEXT  reports. 


1.5.2 


EXPECT  Directive 


The  EXPECT  directive  provides  the  user  with  a means  to  monitor  the  value 
of  selected  variables  and  a method  by  which  variables  which  exceed  certain, 
boundaries  nay  be  detected  and  reported.  There  3re  two  formats  for  the  EXPECT 
directive: 


". EXPECT, <variable>  = < Iow-value> , <high-value>" 

". EXPECT, <variable>  = <value>,  TOLERANCE  = <error>" 

In  the  first  form  the  expected  range  of  values  of  the  named  variable  is  speci- 
fied by  <low-value> , <high-value>.  In  the  second  form  the  expected  value 
together  with  a tolerance  for  error  of  the  named  variable  are  specified.  The 
EXPECT  directive  must  be  placed  in  the  body  of  executable  text  for  a module. 
During  Test  Execution  a message  is  produced  if  the  assigned  value  of  the  named 
variable  falls  outside  the  declared  value  range. 

The  EXPECT  directive  generates  a monitor  statement,  as  follows: 

for  " . EXPECT, <variable>  = <low-value> , <high-value>" 

MONITOR  (<variable>  LS  <iow-value>  OR  <variable>  GR 


<high  -value>) < variable >$ 


for  ".  EXPECT, <variable>  = <value>,  TOLERANCE  = <error>" 

MONITOR  (<variable>  LS  <vaiue>  - <error>  OR  <variable>  GR 
<value>  + <error>) <variab ie> S 


1.5.3  TRACE  and  OFFTRACE  Directives 


The  TRACE  and  OFFTRACE  directives  allow  the  user  to  observe  the  effect 
of  computation  upon  the  variables  in  the  program  at  execution  time.  The  TRACE 
directive  establishes  the  place  in  the  program  flow  where  tracing  is  to  begin 
for  a specified  variable;  the  OFFTRACE  directive  establishes  the  place  where 
tracing  ceases.  The  format  for  these  directives  are: 

" . TRACE, <name-l> , <name-2> .... , <name-n>" 

" .OFFTRACE, <name-l> ,<name-2> , . . . ,<name-n>" 

The  value  of  the  named  variable  is  monitored  during  Test  Execution.  For  a 
particular  variable,  monitoring  commences  when  the  TRACE  directive  is  en- 
countered in  the  execution  of  the  instrumented  module;  monitoring  is  terminated 
when  the  OFFTRACE  directive  is  encountered. 

The  TRACE  directive  generates  the  following  statements: 
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" . TRACE , <name-l> , <name-2> , . . . , <name-n>" 

ITEM  FLAG ' 1 B$ 

ITEM  FLAG '2  B$ 

ITEM  FLAG ' n B$ 

FLAG ' 1 = 1$ 

FLAG’ 2 = 1$ 

FLAG ' n = 1$ 

MONITOR  (FLAG ' 1)  <name-l>$ 

MONITOR  (FLAG '2)  <name-2>$ 

MONITOR  (FLAG'n)  <name-n>$ 

The  OFFTRACE  directive  sets  the  specified  flags  to  zero. 
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JAVS  PROCESSING  STEPS 


JAVS  operates  as  a system  of  compatible  tools  which  communicate  through 
a common  database.  The  order  in  which  the  processing  steps  are  executed  de- 
pends upon  the  task  that  the  user  wishes  to  accomplish.  Source  text  (BASIC) 
processing  must  be  executed  first  in  order  to  build  the  database  library. 

The  following  tasks  can  be  aided  bv  JAVS,  using  the  processing  steps 


in  the  specified  order: 

TASK 

Text  reformatting 

Document ing 

Debugging  using 
directives 

Testing 

Retesting 


PROCESSING  STEPS 
BASIC 

BASIC, STRUCTURAL  ASSIST, DEPENDENCE 

BASIC .STRUCTURAL . INSTRUMENT , 

Test  Execution 

BAS I C .STRUCTURAL , INSTRUMENT , 

Test  Execution, ANALYZER 

BAS  I C , S TRUCTURAL , INSTRUMENT , 

Test  Execution, ANALYZER, ASSIST, 
DEPENDENCE 


In  most  cases  BASIC,  STRUCTURAL,  and  INSTRUMENT  processing  need  to 
be  performed  only  once. 

The  overlay  version  of  JAVS  consists  of  the  same  processing  steps  as  the 
standard  (non-overlay)  version  augmented  by  the  following  features: 

• Smaller  core  size  required  to  operate 

• Macro  commands  to  permit  shorter  command  streams 

• Operation  of  multiple  JAVS  processing  steps  within  a single  activity 

• Extensibility  for  a planned  interactive  version  of  JAVS 
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2.1  SOURCE  TEXT  PROCESSING 


The  analysis  of  a JOVIAL  program  begins  with  3ASIC,  where  a LI3NEW  is 
made  with  information  describing  the  texts  (see  Fig.  2.1).  Each  START- TERM 
sequence  in  the  JOVIAL  source  is  broken  down  into  a series  of  ir.vokable  modu- 
les. The  information  saved  for  each  module  is  a module  descriptor  block, 
a statement  descriptor  table,  a statement  table,  a symbol  locator  table,  and  a 
symbol  table.  The  results  of  3ASIC  processing  can  be  displayed  with  the 
standard  print  commands  (Sec.  4,  PRINT,  [option]). 


Figure  2.1.  BASIC  processing 


2.2  STRUCTURAL  ANALYSIS 


The  analysis  of  a set  of  modules  continues  with  STRUCTURAL,  where  infor- 
mation describing  the  graphical  properties  of  each  module  is  added  to  the  in- 
formation generated  in  BASIC.  STRUCTURAL  begins  with  a library  created  by 
BASIC.  In  BASIC,  processing  is  done  on  one  or  more  START-TERM  texts,  breaking 
each  such  text  down  into  one  or  more  invokable  modules.  STRUCTURAL  processing 
is  done  on  a single  module  at  a time. 

Normally,  the  library  generated  during  BASIC  is  processed  as  LIBNEW,  a 
read/write  library  during  STRUCTURAL.  However,  if  it  is  used  as  LIBOLD,  a 
read  only  library,  then  a LIBNEW  must  also  be  provided.  If  LIBOLD  is  used,  as 
each  module  is  processed  by  STRUCTURAL,  the  BASIC  data  for  the  module  is  first 
copied  to  LIBNEW  from  LIBOLD,  and  then  the  new  structural  data  is  added. 
STRUCTURAL  processing  is  shown  in  Fig.  2.2. 


from 

BASIC 


FROM  BASIC 


«o 


C 


Figure  2.2.  STRUCTURAL  Processing 
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STRUCTURAL  performs  two  cvpes  of  computations: 

1.  Later-statement  analysis  which  establishes  statenent-to- 
atatement  links  (e.g.,  in  IF EITH-ORIF  statement  sequences) 

"*  Module  structural  analysis  which  identifies  the  nature  of 
r low  within  the  nodule. 


The  structural  analysis  performed  by  STRUCTURAL  on  each  invokable  module 
(program,  procedure,  or  close)  consists  of  determining  all  decision-to-dec ision 
pa  ns  ’ pat.ns)  in  ...e  module.-  Decision-to-decision  paths  are  sequences  of 
statements  between  decision,  or  branch,  points.  Programs  are  represented  as 
a directed  grapn  or  DD-paths,  as  shown  in  Fig.  2.3  and  Fig.  2.4.  Figure  2 3 

SHUiSVinS-  35lThi?  for  sach  DD--”th  111 

contains  1.  DD-?aths.  Below  eacn  DD-path  number  is  listed  the  order  in  which. 


tne  statements 
statements  13, 


are  placed  on  each  DD-path.  For  example,  DD-path 
-3,  -9,  30,  and  31,  in  that  order. 


■>  « 


consists  of 
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Statement  Execution  Order 
DD-Path 

1 2 3 4 ? 6 7 8 9 10  11  12 


. JAVSTDTT  EXAKPL  COMPUTE  ( COKPOL  ) 
START 

PROC  EXAKPL  ( AA  - BB  ) $ 

ITIX  AA  P $ 

ITZN  B3  P $ 


ARRAY  CC  2 2 F 3 
BEGIN 
BECIN 

+10.E-001  ♦10.E-001  END 
BEGIN 


410.E-001  +10.E-001  END 
END 
BECIN 

MONITOR  B3  , CC  $ 

IFEITh  AA  LS  OO.E-OOl  3 


3 11 


16 

Bfl  - - AA  $ 

2 

17 

CRIP  AA  EQ  OO.E-OOl 

9 

2 

IS 

BECIN 

19 

BB  - OO.E-OOl  3 

20 

FOR  I - 0 , 1 , 1 

9 

BECIN 

FOR  J • 0 , 1 , 1 $ 

CC  (3  I , J 3)  • 00.5-C01  I 
END 

RETURN  $ 


END 

ORIP  1 $ 

BB  • AA  3 

END 

FOR  K • 0 , 1 . 1 9 


CC  (3  K , 0 3)  • SB  / 20.R-O01  $ 
END 

TERM  I 


Figure  2.3.  Example  of  Structural  Analysis 
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2.3  MODULE  INSTRUMENTATION 


i 


This  step  perforas  the  instrumentation  of  modules  which  have  been  pro- 
cessed through  BASIC  and  STRUCTURAL.  The  primary  result  of  this  step  is  a 
set  of  probed  modules  which  can  then  be  compiled  in  instrumented  form  for  use 
in  Test  Execution  (see  Sec.  2.4).  The  instrumented  modules  are  logically 
identical  to  the  original  source  code.  The  probe  statements  are  saved  on  the 
library  along  with  data  generated  by  BASIC  and  STRUCTURAL  (e.g.,  the  source 
text,  etc.).  INSTRUMENT  processing  is  shown  in  Fig.  2.5. 


from 

STRUCTURAL 


*FR0M  STRUCTURAL 


Figure  2.5.  INSTRUMENT  Processing 


iW 


here  are  two  types  of  instrumentation  generated  during  INSTRUMENT: 


Structural  Ins  tr-coenta  tier..  Software  probes  are  automatically 
inserted  into  the  source  text  at  each  invocation  point,  each 
return  point,  and  each  statement  which  begins  a DD-path.  Each 
probe  includes  a call  to  special  auditing  routines  which  cap- 
ture and  record  information  concerning  flow  of  control  in  the 
executing  module(s). 


JAVS  Directive  Instrumentation.  Software  o 
inserted  inthe  source  text  for  JA75  iirecti 
automatically  expended  into  A V T it.  code 
suits  or  assignment  and  exchange  statements 
each  directive  controls  execution-time  outp 
spersed  with  normal  program  output. 


robes  are  manually 
ves  (Sec.  1.5)  which 
to  monitor  the  re- 
curing  Test  Execution 
ut  which  is  inter- 
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2.4  MODULE  TESTING  ASSISTANCE  AND  SEGMENT  ANALYSIS 


The  purpose  of  ASSIST  is  to  provide  computational  and  output  reports  for 
use  by  program  testers  to  meet  the  following  objectives: 

• To  provide  "source  text  flow"  information  needed  to  support  de- 
tailed analyses  of  the  legitimacy  of  test  cases 

• To  provide  for  identification  of  properties  of  sequences  of 
DD-paths 


ASSIST  commands  are  designed  to  provide  detailed  information  on  specific 
DD-paths  in  modules.  Some  of  the  commands  require  that  the  DD-paths  for  which 
test  assistance  is  needed  be  identified.  Therefore,  ASSIST  is  usually  run 
after  an  initial  series  of  test  cases  is  run,  and  additional  information  is 
needed  to  assist  the  user  in  setting  up  new  test  cases  that  give  coverage  of 
specific  DD-paths.  ASSIST  reports  are  most  effectively  used  for  retesting 
assistance  and  for  computer  documentation  in  conjunction  with  reports  from 
the  standard  print  commands  and  from  DEPENDENCE  (Sec.  2.5). 

ASSIST  operates  from  LIBOLD  and,  under  active  user  control,  generates 
reports  of  various  kinds.  It  is  assumed  that  BASIC  and  STRUCTURAL  have  been 
completed  for  each  module  present  on  LIBOLD  for  which  analyses  are  requested 
by  ASSIST  commands.  ASSIST  processing  is  shown  in  Fig.  2.6. 


from 

STRUCTURAL 


Figure  2.6.  ASSIST  Processing 
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2.5  RETESTING  GUIDANCE  AND  ANALYSIS 

The  purpose  of  DEPENDENCE  is  to  provide  the  means  to  assess  the  impact 
of  program  modir ioatior.s  for  a set  of  test  cases.  In  contrast  with  ASSIST 
ipwnicn  examines  the  details  of  pregram  flow  within  a module),  DEPENDENCE  is 
concerned  primarily  with  inter-module  dependencies . Taken  with  the  reports 
from  both  ASSIST  and  ANALYZES,  the  analyses  performed  by  DEPENDENCE  allow 
the  tester  to  specify  the  subset  of  test  cases  which  must  be  re-executed  in 
order  to  maintain  comprehensive  testing  coverage.  The  reports  from  DEPEND- 
ENCE coupled  with  seme  of  the  ASSIST  reports  provide  valuable  software  docu- 
mentation . 

DEPENDENCE  operates  from  LI30LD,  generating  reports  under  active  user 
control.  It  is  assumed  that  3ASIC  and  STRUCTURAL  have  been  completed  for 
every  module  present  on  LI30LD.  DEPENDENCE  processing  is  shown  in  Fig.  2.7. 


STRUCTURAL 


*FR0M  STRUCTURAL 


Figure  2.7.  DEPENDENCE  Processing 
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2.6  TEST  EXECUTION 


The  purpose  of  Test  Execution  is  to  collect  test  execution  data  and  per- 
formance data  from  JAVS  directives  while  executing  a set  of  instrumented  modu- 
les produced  by  INSTRUMENT.  Test  Execution  differs  from  other  JAVS  steps  in 
that  the  instrumented  program  itself  is  executed,  not  a JAVS  processing  step. 
There  is  no  access  to  the  JAVS  library  during  Test  Execution.  Rather,  the 
probe  data  is  recorded  on  a test  file;  these  data  include  the  information 
needed  by  ANALYZER  to  properly  correlate  with  data  on  the  library  (e.g.,  module 
name,  test  name,  and  DD-path  number). 

The  instrumented  program  under  test  is  first  compiled,  then  loaded  with 
JAVS  data  collection  modules.  The  program  operates  normally,  reading  its  own 
data  and  writing  its  own  outputs.  During  program  execution,  the  instrumented 
modules  call  the  data  collection  routines  which  record  on  AUDIT  (the  test  file) 
an  execution  trace  and  accumulated  data  on  module  invocations  and  return  and 
on  DD-path  traversals.  Performance  data  resulting  from  JAVS  computation 
directives  (Sec.  1.5)  is  interspersed  with  normal  program  output  for  the 
printer.  Test  Execution  processing  is  shown  in  Fig.  2.8. 

Each  Test  Execution  may  consist  of  a number  of  test  cases.  The  program 
identifies  the  start  of  each  new  test  case  by  executing  a call  to  one  of  the 
data  collection  routines;  the  end  of  all  test  cases  is  similarly  treated. 

These  identification  calls  can  be  manually  inserted  by  the  user  in  the  program 
prior  to  compilation,  or  they  can  be  inserted  automatically  during  instrumen- 
tation by  using  the  INSTRUMENT, STARTTEST  or  INSTRUMENT, STOPTEST  commands 
(Sec.  5).  All  other  instrumentation  of  the  source  is  automatically  performed 
by  INSTRUMENT. 

2.6.1  JAVS  Data  Collection  for  Structural  Instrumentation 

There  are  four  procedures  in  the  JAVS  data  collection  routines  which  mav 
be  invoked  during  test  execution: 


• PROBE*  is  called  at  the  beginning  of  each  DD-path  in  an  instru- 
mented module  (INSTRUMENT  option  DDPATHS  or  FULL) 

• PROBM*  is  called  upon  module  invocation  or  return  in  an  instru- 
mented module  (INSTRUMENT  option  INVOCATION,  DDPATHS  or  FULL) 

• PROBI*  is  called  to  identify  a new  test  case,  or  to  end  all 
test  cases 

• PROBD*  is  called  to  record  descriptive  information  about  a 
test  on  the  test  file 


INSTRUMENT  automatically  generates  the  probes  for  PROBE  and  PROBM.  The  calls 
to  PROBI  are  inserted  by  the  user,  manually  or  by  command,  in  the  instrumented 
source  (see  Sec.  2.6.2).  The  optional  calls  to  PROBD  are  inserted  manually  by 
the  user. 


An  arbitrary'  name  used  in  data  collection  routines. 


MAY  ALSO  CONTAIN  CALLS  TO  PROBI  AND  PROBD 


The  data  collection  routines  utilize  a COMMON  block  (PROBEC*)  for  com- 
munication with  one  another  and  for  storage  of  data  by  module  and  DD-path.  In 
the  standard  version  of  the  COMPOOL  for  the  data  collection  routines,  provision 
is  made  for  a maximum  of  100  instrumented  modules  and  2000  DD-paths  for  those 
modules  whose  DD-paths  are  instrumented.  If  larger  space  is  required,  the 
data  collection  routines  must  be  recompiled  with  appropriate  changes  made  in 
their  COMPOOL. 

Caution : The  program  being  analyzed  may  include  symbols  which  conflict 

with  the  names  used  in  the  data  collection  routines  for  the  procedures,  the 
COMMON  block,  or  the  test  file.  Should  such  a conflict  exist,  (1)  appropriate 
changes  must  be  made  in  the  source  for  the  data  collection  routines  and  their 
COMPOOL  and  (2)  INSTRUMENT  processing  must  be  done  with  the  PROBE  option  com- 
mand (s)  to  change  the  names  of  the  data  collection  routines. 

Summary  data  is  accumulated  in  the  workspace  only  after  the  first  call 
is  made  to  PROBI.  Thereafter  whenever  a call  is  made  to  PROBI  signalling  the 
beginning  of  a new  test  case  (or  the  end  of  all  test  cases)  the  accumulated 
data  is  recorded  on  AUDIT  and  the  workspace  is  cleared.  For  each  call  to 
PROBE  or  PROBM,  an  execution  trace  record  is  recorded;  for  each  call  to 
PROBI,  test  case  identification  data  is  recorded;  for  each  call  to  PROBD, 
descriptive  information  is  recorded. 

For  each  module  the  amount  of  data  which  it  is  possible  to  accumulate 
is  controlled  by  the  level  of  structural  instrumentation  done  during  INSTRU- 
MENT. If  the  module  is  instrumented  at  the  invocation  level,  only  PROBM  is 
called  and  DD-path  executions  cannot  be  recorded.  If  the  module  is  instru- 
mented at  the  DD-path  level,  both  PROBM  and  PROBE  are  called,  and  full  data 
acquisition  can  be  made. 

The  amount  of  data  actually  recorded  during  a test  is  further  controlled 
by  a parameter  to  PROBI  (see  Sec.  2. 6. 2. 2). 


2.6.2  Compiling  The  Instrumented  Program 

During  INSTRUMENT  processing,  the  instrumented  program  source  must  first 
be  written  to  a punch  file  from  the  library  by  using  the  command 

PUNCH , JAV3TEXT  = <text-name> .INSTRUMENTED  = <specif ication> . 


while  processing  under  JAVS  execution.  Next  the  instrumented  program  source 
is  prepared  for  the  compiler  as  described  in  the  following  subsections. 


2. 6. 2.1  References  to  Data  Collection  Routines  and  Test  File. 

If  the  program  has  a COMPOOL,  the  procedure  declarations  for  the  data 
collection  routines  must  be  added  to  the  COMPOOL.*  If  the  program  has  no 


If  the  JOVIAL  compiler  accepts  a list  of  processed  COMPOOLs  while  compiling 
executable  modules,  then  one  for  the  source  shown  in  Fig.  2.9  must  be  in- 
cluded in  the  list. 
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COMPOOL,  the  one  shown  in  Fig.  2.9  must  be  provided.  This  is  necessary  in 
order  to  compile  the  instrumented  source. 

A FILE  declaration  for  the  test  file  (AUDIT)  may  also  be  necessary  in 
the  compilation  process.*  The  location  or  the  FILE  declaration  (i.e.,  in  a 
COMPOOL  or  in  the  main  program)  is  dependent  on  the  JOVIAL  compiler  being 
used.  Figure  2.9  contains  the  proper  file  statement  for  RADC. 
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Figure  2.9.  COMPOOL  for  References  to  JAVS  Data  Collection  Routines 


Some  JOVIAL  compilers  require  the  FILE  statement  to  be  in  the  main  program; 
others  require  it  to  be  in  a processed  COMPOOL  loaded  with  the  executable 

code. 
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2. 6. 2. 2 


Test  Case  Identification  and  Test  File  Control. 


At  appropriate  places  in  the  instrumented  source  program  (i.e.,  where 
a new  test  case  begins  and  at  the  end  of  all  test  cases)  a call  to  PROBI  must 
be  inserted.  PROBI  performs  two  services:  it  identifies  each  test  case  and 
controls  the  recording  of  data  on  the  test  file.  PROBI  has  two  parameters: 
the  first  is  used  as  a test  case  name  on  ANALYZER  reports  and  is  a Hollerith  name 
of  8 characters;  the  second  is  used  to  control  the  amount  of  data  actually 
recorded  on  the  test  file. 

The  possible  values  for  the  test  file  control  parameter  TFLAG  are  shown 
in  Table  2.1.  A zero  value  signals  the  end  of  all  test  cases.  A nonzero 
value  signals  the  start  of  a new  test  case  (and  the  end  of  the  previous  test 
case,  if  any).  The  value  of  the  second  parameter  (if  nonzero)  determines  the 
amount  of  execution  tracing.  If  TFLAG  is  1,  no  tracing  is  maintained;  if 
TFLAG  is  2,  invocations  and  returns  are  traced;  if  TFLAG  is  3,  invocations, 


returns , 

and  DD-paths 

are  traced. 

TABLE  2.1 

TEST  FILE  DATA  CONTROL  WITH 

PROBI 

TFLAG 

SIGNAL 

TEST-FILE  DATA  RECORDED 

ANALYZER  REPORT  OPTIONS 

0 

end-of-test 

file 

(last)  test  case  summary 

1 

new  test 
case 

test-case  summary 

SUMMARY , HIT,  NOTHIT, 
MODLST,  DDPATHS 

2 

new  test 
case 

test-case  summary,  module 
invocation/return  trace 

SUMMARY,  HIT,  NOTHIT, 
MODLST,  TIME,  MODTRACE, 
DDPATHS 

3 

new  test 
case 

test-case  summary,  module 
invocation/return  trace, 
DD-path  execution  trace 

SUMMARY,  HIT,  NOTHIT, 
MODLST,  TIME,  MODTRACE, 
DDTRACE , DDPATHS 

2. 6. 2. 3 Test  Description. 

At  user  option,  descriptive  information  about  the  test  can  also  be  re- 
corded on  the  test  file  by  inserting  PROBD  calls.  There  are  two  parameters 
to  PROBD  (see  Fig.  2.9):  the  first  parameter  is  a Hollerith  test  description 
string  of  80  characters,  and  the  second  parameter  controls  the  initialization 
of  data  workspace.  The  value  zero  indicates  the  start  of  a test  set  (i.e.,  a 
new  set  of  test  cases),  and  a nonzero  value  indicates  the  start  of  a new 
test  case.  PROBD  calls,  if  used,  should  immediately  precede  PROBI  calls. 

Each  PROBD  call  results  in  a single  line  of  output  during  ANALYZER  pro- 
cessing. There  is  no  limitation  on  the  number  of  consecutive  calls  to  PROBD. 
When  the  test  file  is  analyzed  by  ANALYZER,  the  descriptive  information  is 
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printed  cn  the  output  file  as  encountered.  The  purpose  of  PROBD  is  to  allow 
the  user  a facility  for  correlating  program  behavior  to  test  results.  For 
example,  strategically  placed  PROBD  invocations  can  identify  program  linkages 
executed  for  specific  tests. 

•2.6.2.-*  Compilation. 

The  procedure  for  compiling  the  instrumented  source  program  with  the 
JOVIAL  compiler  is  as  follows: 

1.  Punch  the  ins trumented  text  after  INSTRUMENT  execution. 

(Sec.  2.6.2). 

2.  If  the  text  contains  structural  instrumentation  (INSTRUMENT 
default  option,  INVOCATION,  ODPATHS  or  FULL)  then 

• Provide  COMPOOL  definitions  for  data  collection 
routines  (Sec.  2. 6. 2.1). 

• Insert  PROBI  and  PROBD  calls  (Secs.  2. 6.2.2  and 

2. 6. 2. 3). 

3.  Compile  the  COMPOOL  and  the  instrumented  program.  If  the  text 
contains  JAVS  directives  for  performance  daca  (INSTRUMENT 
options  DIRECTIVES,  FULL) , use  the  MONITOR  option*  for  the 
JOVIAL  compiler.  Additional  core  storage  may  be  required  for 
compiling  the  instrumented  code. 

Figure  2.10  shows  an  example  listing  of  probed  text  with  PROBI  calls  inserted. 


v 


In  the  present  JAVS  implementation,  JAVS  performance  directives  make  use  of 
the  MONITOR  feature  available  in  some  JOVIAL  compilers,  including  the  JOCIT 
JOVIAL  compiler  at  RADC. 
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Figure  2.10.  Excerpt  from  Probed  Text 
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;.o.3  Loading  the  Instrumented  Program 


If  the  instrumented  program  contains  structural  probes  (i.e.,  calls  to 
PR03M,  PR03E,  PR03I  or  PR03D)  the  JAV3  data  collection  routines  must  be  added 
to  the  load  module  for  Test  Execution.  In  addition,  provision  must  be  made 
for  the  test  file  to  be  saved  on  a suitable  medium  (e.g.,  tape  or  disk). 


The  requirements  for  main  memory  are  larger  in  Test  Execution  than  in 
normal  program  execution  due  to  the  following  factors: 

• Instrumented  code  is  larger  than  non- instrumented  code. 

• JAVS  data  collection  routines,  workspace,  and  test  file  are 
needed  for  structural  instrumentation. 


Code  expansion  due  to  instrumentation  depends  on  the  nature  of  the  source 
program.  Experience  has  shown  that  code  expansion  of  programs  with  moderately 
complex  control  structures  can  have  1002  expansion  from  DD-path  instrumentation. 
The  JAVS  data  collection  routines,  although  relatively  small,  utilize  about 
3000  words  for  data  space  in  che  standard  configuration;  the  space  required 
for  the  test  file  control  information  and  buffer  space  is  installation  depend- 
ent. 


2 . 6 . 1 Test  Execution  Input  and  Output 


The  input  data  requirements  for  test  execution  are  those  for  normal 
program  execution.  Thera  is  no  input  data  read  by  the  JAVS  data  collection 
routines . 


In  addition  to  normal  program  output,  two  types  of  output  result  from 
test  execution  of  an  instrumented  program:  a test  file  (for  ANALYZER)  which 
contains  execution  data  collected  from  structural  instrumentation  probes  and 
printout  from  the  JAVS  performance  probes.  Figure  2.11  contains  a sample  out- 
put from  JAVS  performance  probes. 
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Figure  2.11.  Performance  Data  from  JAVS  Directives 
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2.7  TEST  EFFECTIVENESS  MEASUREMENT 


The  purpose  of  ANALYZER  is  to  provide  test  effectiveness  measurement  and 
test  execution  tracing  in  terms  of  module  invocation,  DD-paths  exercised, 
and  statements  executed.  For  a specified  set  of  modules,  ANALYZER  supplies  the 
* following  measures  of  test  case  effectiveness. 

• A summary  at  the  module  level  of  the  coverage  achieved. 

• A table  of  DD-paths  exercised  and  the  number  of  times  each 
DD-path  was  traversed. 

• A list  of  the  DD-paths  not  executed. 

• A source  listing  of  each  module  including  the  number  of  times 
each  statement  was  executed. 

• A source  listing  of  the  key  statements  for  each  DD-path  includ- 
ing the  number  of  times  each  DD-path  was  executed. 

ANALYZER  supplies  the  following  types  of  execution  tracing: 

• A list  of  the  module  invocations  and  returns  and  the  level 
of  invocation,  or 

• A list  of  the  DD-paths  interspersed  with  the  module  invocations 
and  returns. 


In  addition,  ANALYZER  summarizes  the  time  spent  in  each  module  as  measured  by 
the  system  clock. 

ANALYZER  operates  from  LIBOLD  and  a saved  test  file  AUDI1  produced  by 
Test  Execution.  T t is  assumed  that  BASIC  through  INSTRUMENT  and  Test  Execu- 
tion have  been  accomplished  for  the  specified  modules.  ANALYZER  processing  is 
shown  in  Fig.  2.12. 
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Figure  2.12.  ANALYZER  Processing 
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JAVS  CONSTRAINTS 


JAVS  imposes  certain  restrictions  on  the  size  of  the  database  library, 
the  command  language,  and  the  source  text  to  be  analyzed.  Most  of  the  limita- 
tions based  on  size  are  generous  (e.g.,  the  maximum  number  of  nested  IF  state- 
ments is  100).  Some  of  the  limitations,  such  as  those  in  the  Test  Execution 
process,  can  be  raised  by  recompiling  parts  of  JAVS.  Some  of  the  restrictions 
are  based  upon  computer  page  dimensions  and  cannot  be  changed. 

A number  of  the  constraints  which  affect  the  incoming  JOVIAL  source  code 
are  founded  in  the  principle  of  analyzing  invokable  modules  separately.  The 
dialects  of  JOVIAL  recognized  by  JAVS  allow  certain  constructs  involving  jumps 
to  global  labels,  invocations  of  externally  declared  switches,  and  TEST  state- 
ments where  the  FOR  variable  is  external  to  the  module.  Some  of  these  con- 
structs require  modification  of  the  JOVIAL  source  code,  and  some  cause  a 
warning  message  to  be  issued  to  make  the  user  aware  of  limitations  in  the  DD- 
path  test  measurement  report  and  execution  tracing. 

The  constraints  are  listed  in  sections  (Sec.  3.2  through  3.8)  appropriate 
to  a particular  JAVS  processing  step.  Universal  constraints  (Sec.  3.1)  affect 
all  of  JAVS  processing.  The  terminology  used  in  describing  the  constraints 
requires  knowledge  of  JOVIAL  and  JAVS.  The  user  should  refer  to  the  JOCIT 
Compiler  Users  Manual^  for  JOVIAL  terms  and  to  the  index  in  this  manual  for 
direction  to  the  descriptions  and  references  to  JAVS  terms. 


,1  UNIVERSAL  CONSTRAINTS 


Maximum  ) continuation  :ards  for  any  given  JAVS  command. 

Maximum  -•  a anas  in  any  given  JAVS  ccmmand. 

Maximum  . ' 3 nodules  selected  for  any  given  JAVS  command  iteration 


.Maxinun  150  uori-puirs  in  a statenent  block. 

Maximum  110  stat=ments  on  any  00-path. 

Maximum  15  internal  aata  base  tables  during  any  JAVS  execution. 
100  JAVS  errors  produce  a fatal  error. 

Maximum  150  known  *.  cules  during  any  one  JAVS  execution  (i.e., 
total  nodules  in  ne  or  both  libraries). 

In  order  to  v.urce  a previously  made  library,  the  name  specified 
for  an  ALTER  II.-  • . must  be  the  sane  as  when  it  was  a CREATE 

LI 3 RASY . 

Maximum  150  nodul  ;s  per  JAV5TEXT. 

Maxim-ms  :0  or.araet-rs  per  card  image  read. 

Maximum  1-5  cr.aractars  per  line  of  output. 

No  analysis  is  performed  on  a DIRECT  code  sequence. 

The  re cc cniced  dialects  of  JOVIAL  include  JOVIAL/ J3,  CDC  JOVIAL, 
and  Honeywell  JOVIAL.  The  combination  of  these  is  processed  by 
JAVS . 


3ASIC  automatically  separates  long  source  statements  into  a sequence  of  state- 
ments. The  first  statement  is  given  the  statenent  type  according  to  the 
original  JOVIAL  source  statement.  Subsequent  statements  are  of  type  continua- 
tion (C0NT) . 
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JAVS  BASIC  CONSTRAINTS 


BASIC  processing  is  capable  of  handling  quite  large  source  text  files. 
Unusually  large  programs  may  have  to  be  processed  by  several  successive  execu- 
tions of  BASIC,  each  operating  on  a separate  file  of  START-TERM  texts.  In 
this  event  it  is  essential  that  JAVSTEXT  directives  are  inserted  in  the  source 
code  prior  to  BASIC  processing. 

The  following  implementation  constraints  are  the  current  ones  which  must 
be  observed  during  BASIC  processing: 

1.  Each  module  placed  on  the  same  library  must  have  a unique 

module  name  for  a given  JAVSTEXT  name.  For  this  purpose 

only  the  first  eight  characters  of  any  name  are  used.  The 
first  six  characters  should  be  unique  (a  compiler  restriction). 

2.  COMPOOL  texts  should  only  be  processed  through  BASIC. 

3.  If  any  errors  are  detected  in  JOVIAL  source  by  BASIC,  one  or 

more  statements  on  the  library  may  be  flagged  as  not  parsed. 

The  errors  found  in  BASIC  are  summarized  in  Appendix  B. 

4.  Hollerith  and  transmission  type  items  must  not  exceed  120 
characters . 

3.  Only  one  COMPOOL  for  each  execution  of  BASIC  can  be  placed  on  the 
library,  when  processing  both  COMPOOL  and  executable  text.  If 
one  or  more  COMPOOLS  are  referenced  by  an  executable  text,  the 
COMPOOL(S)  need  not  be  processed  by  BASIC,  but  the  program  text 
must  contain  a JAVSTEXT  directive  which  indicates  the  presence 
of  COMPOOL  references. 


3.3  JAVS  STRUCTURAL  CONSTRAINTS 


f 


1.  A module  should  not  GOTO  a statement,  directly  or  indirectly 
through  a SWITCH,  which  is  in  another  nodule. 

2-  A TEST  statement  must  not  appear  in  the  range  or  a single  factor 
FOR  statement  sequence. 

3.  Function  calls  with  side  effects  (i.e.,  two  successive  calls  to 
the  function  which  produce  different  results)  are  not  permitted  in 

FOR,  IF,  IFEIIH,  and  3R1F  statements. 

4.  A declaration  statement  containing  an  END  cannot  appear  as  the 
last  statement  preceding  the  TERM  statement  of  a program,  pro- 
cedure, or  close. 

5.  The  maximum  depth  of  nesting  of  control  or  compound  statements 
( IFEIIH,  ORIF.'lF,  FOR,  3EGIN)  is  100. 

6.  The  maximum  number  of  DD-paths  which  can  begin  at  a statement 
is  100. 

7.  The  maximum  number  of  statements  on  a single  DD-path  is  100. 

3.  CLOSE  invocations  which  appear  as  switch  points  in  SWITCH 
declarations  are  treated  as  null  switch  points. 

9.  SWITCH  invocations  which  appear  3S  switch  points  (nested  switches) 
in  SWITCH  declarations  are  treated  as  null  switch  points. 

10.  Invocations  of  externally  declared  switches  are  treated  as 
RETURNS . 

11.  The  first  three  factor  FOR  statement  in  a parallel  FOR  is 
assumed  to  be  the  controlling  FOR.  If  there  are  no  three 
factor  FOR  statements  in  the  parallel  FOR,  the  first  FOR  state- 
ment is  chosen  as  the  controlling  FOR  for  the  purpose  of  con- 
structing inters tatement  pointers  in  the  JAVS  statement  de- 
scriptor blocks. 

12.  All  programs,  close  and  procedures  must  contain  a 3EGIN-END 
set  of  statements  surrounding  the  executable  code. 

13.  CLOSE  declarations  within  a FOR  statement  may  not  use  a TEST 
statement  to  reference  the  active  FOR  variable. 
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3.4  JAVS  INSTRUMENT  CONSTRAINTS 


1.  The  first  three  factor  FOR  statement  in  a parallel  FOR  is 
assumed  to  be  the  controlling  FOR  and  is  instrumented. 

2.  Invocations  of  externally  declared  switches  are  not  instrumented. 

3.  The  maximum  number  of  nested  IF  statements  is  100. 

4.  Subscript  expressions  in  SWITCH  invocations  are  limited  to  72 
characters . 

5.  Item  names  and  switch  names  are  limited  to  30  characters  in 
length. 

6.  The  maximum  number  of  variables  allowed  in  a single  TRACE 
directive  is  18. 

7.  The  maximum  number  of  variables  in  TRACE  directives  is  limited 
to  999  per  module. 

8.  The  maximum  number  of  nested  IFEITH  and/or  IFEITH/ORIF  statements 
is  100. 

9.  The  maximum  DD-path  number  is  9999. 

10.  The  maximum  length  of  the  TEXT  in  an  ASSERT  directive  is  72 
characters . 

11.  The  functional  modifiers  BIT,  CHAR,  MANT , NENT,  POS  and  BYTE 
may  not  appear  in  the  numeric  formulas  for  FOR  statements; 
i.e.,  no  side-effects  are  allowed  in  the  initial  value  formula. 

12.  FOR  variable  may  not  appear  in  TRACE  or  EXPECT  directives. 

13.  A declaration  statement  containing  an  END  cannot  appear  as  the 
last  statement  preceding  the  TERM  statement  of  a program,  pro- 
cedure or  close. 


JAVS  ASSIST  CONSTRAINTS 


1.  Maximum  of  100  DD-paths  per  reaching  sec  path. 

2.  Maximum  of  100  ouCvays  per  decision. 

3.  Maximum  of  1200  DD-pachs  per  analyzed  module  for  reaching  set. 

4.  Maximum  of  2400  scacemencs  per  analyzed  module  for  reaching  sec. 

5.  Maximum  of  200  scacemencs  in  reaching  sec. 

o*.  Maximum  100  JAVSTEXTs  specified  for  cross-ref erence  mapping. 

7.  Maximum  of  125  modules  specified  for  cross-reference  mapping. 
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3.6  TEST  EXECUTION  CONSTRAINTS 


There  is  no  probe  test  data  recorded  on  AUDIT  until  after  the  first 
invocation  of  PR0B1  has  been  made.  (PROBI  invocations  must  be  inserted 
manually  or  by  using  the  INSTRUMENT,  STARTTEST  and  INSTRUMENT,  STOPTEST 
commands.)  The  PROBI  invocation  which  indicates  end-of-test  must  be  executed 
to  properly  terminate  data  recording  on  AUDIT.  When  this  end-of-test  invoca- 
tion is  made,  a message  is  issued. 

There  is  a limitation  of  100  instrumented  modules  in  the  workspace  for 
the  JAVS  data  collection  routines.  This  limitation  may  be  changed  by  recom- 
piling the  routines. 

There  is  a limitation  of  2000  instrumented  DD-paths  in  the  workspace  for 
the  JAVS  data  collection  routines.  This  limitation  may  be  changed  by  recompil- 
ing the  routines. 


3.7  JAVS  DEPENDENCE  CONSTRAINTS 


1.  Maximum  100  modules  in  each  of  the  groups  in  group  dependency 
analysis. 

-•  Maximum  of  1x5  modules  in  sum  of  group  A and  group  C in  group 
dependency  analysis. 

3.  Maximum  bandwidth  of  5 specified  in  3 AND  analysis. 


3.8  JAVS  ANALYZER  CONSTRAINTS 


In  a single  execution  of  ANALY'ZER,  either  MODTRACE  or  DDPTRACE  option 
may  be  used,  but  not  both. 

Since  ANALYZER  does  not  reposition  the  file  AUDIT  at  the  conclusion  of 
processing,  two  consecutive  executions  of  ANALY’ZER  in  the  same  command  set 
process  different  test  cases  on  AUDIT. 

Maximum  of  100  test  cases  is  analyzed. 

If  the  test  termination  PROBI  module  is  not  invoked,  ANALYZER  will  pro- 
cess the  test  case  data  on  the  AUDIT  file  up  to  the  start  of  the  last  test 
case.  When  ANALYZER  attempts  to  process  the  last  test  case  on  AUDIT  and  hits 
an  end-of-file  before  the  required  4H(TERM),  written  on  AUDIT  by  the  test 
termination  call  to  PROBI,  the  error  message  "Illegal  record  on  AUDIT  file" 
will  be  issued.  Thus,  if  there  is  only  one  test  case  on  the  AUDIT  file  and 
no  occurrence  of  4H(TERM),  ANALYZER  will  have  no  summary  data  to  process. 
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JAVS  COMMANDS 


JAVS  processing  is  implemented  by  a command  language  (see  Sec.  1.2). 
This  section  describes  the  eight  basic  types  of  commands.  Each  JAVS  command 
starts  with  a keyword.  The  keywords  are  intended  to  be  descriptive,  concise, 
while  maintaining  flexibility  through  their  processing  options.  Table  4.1 
shows  the  relationship  between  the  keywords  and  basic  types  of  commands. 

A partial  list  is  given  below  for  process  option,  execution,  and  print/punch 
commands.  Complete  lists  are  given  for  the  remaining  types  of  commands. 

Section  5 contains  a complete  description  for  each  JAVS  command.  The 
commands  in  Sec.  5 are  presented  alphabetically. 

• Library  commands  - (Sec.  4.1) 

OLD  LIBRARY  = <name>. 


t 


i 

i 

i 

1 


> 

I 


! 


CREATE  LIBRARY  = <name>. 

ALTER  LIBRARY  = <name> . 

DESCRIBE  = <ON/OFF> . 

MERGE. 

• Startup  command  - (Sec.  4.2) 

START. 

• Module  Selection  commands  - (Sec.  4.3) 

JAVSTEXT  = <name> . 

MODULE  = <name> . 

FOR  LIBRARY. 

FOR  JAVSTEXT. 

FOR  MODULE  = <name-l> , . . . ,<name-n> . 

END  FOR. 

• Process  Option  commands  (an  incomplete  list)  ~ (Sec.  4.4) 

BASIC, COMMENTS  = OFF. 

INSTRUMENT, MODE  = FULL. 


i 

I 
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i COMMAND  TYPE 

REWORD 

* Library 
! J 

| 

OLD  LI3RARY 
1 MERGE 

CREATE  LI3RARY 

ALTER  LI3RARY 

DESCRL3E 

i 

f Startup 

START 

Module  Selection 

1 JAVS TEXT  MODULE  FOR  LIBRARY  FOR  JAVST 

1 

! END  FOR 

EXT  FOR  MODULE 

Process  Option 

I 

1 3 ASIC  STRUCTURAL  INSTRUMENT  ASSIST 

DEPENDENCE 

and 

! Process  Execution 

1 ANALYZER 

| 

1 Print /Punch 

1 PRINT  PUNCH 

j Termination 

j 

! END 

| Macro* 

P 

| 3UILD  LI3RARY  PR03E  DOCUMENT  TEST 

k 

Available  only  with  JAVS  overlay  version. 
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Process  execution  commands  (an  incomplete  list)  - Sec.  4.5 


■ 


BASIC. 

STRUCTURAL. 

INSTRUMENT. 

ASSIST, CROSSREF, LIBRARY. 
DEPENDENCE , GROUP .LIBRARY . 
ANALYZER, SUMMARY. 


• Standard  print  and  punch  commands  (incomplete  list)-Sec.  4.6 
PRINT, MODULE  . 

PUNCH, JAVSTEXT=<name>. 

PRINT, DDPATHS. 


• Rut  termination  command  - Sec.  4.7 


END. 


• , Macro  command  - Sec.  4.8 

BUILD  LIBRARY  {-name.-. 
PROBE  { , options  . 
DOCUMENT  -, .options,. 
TEST  {.options-. 
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4.1  LIBRARY  COMMANDS 


Three  of  the  library  commands  (OLD  LIBRARY,  CREATE  LI3RARY,  and  ALTER 
LIBRARY)  define  the  name  and  status  of  the  library  (or  libraries)  during  the 
current  run.  DESCRIBE  command  sets  a flag  to  print  the  library  manager 
statistics  at  the  end  of  the  run.  The  MERGE  command  causes  the  contents  of 
the  library  specified  in  the  OLD  LI3SARY  command  to  be  written  onto  the  library 
specified  by  CREATE  or  ALTER  LI3RARY  command. 


4.1.1  Library  Description  Commands 


• OLD  LI3RARY  = <name>.  This  option  specifies  whether  LI30LD 

is  to  be  used  in  the  current  run,  as  is  normally  the  case 
in  ail  except  3A5IC  and  STRUCTURAL.  The  absence  of  this 
command  indicates  that  no  old  library  will  be  used.  LI30LD 
is  a read-only  library. 

• CREATE  LI3RARY  = <name>.  This  option  specifies  that  LI3NEW  (a 

"new  library")  will  be  created  during  the  current  run,  as 
is  normally  the  case  in  3A5IC.  '.v'hen  this  option  is  speci- 
fied, LI3NEV  is  assumed  to  be  empty  at  the  beginning  of  a 
run.  LI3NEW  is  used  as  a raad/write  library. 

• ALTER  LIBRARY  = <name>.  This  option  specifies  that  LI3NEW  is 

a previously  generated  library  to  be  modified  during  the 
current  run,  as  is  normally  the  case  in  STRUCTURAL.  The 
name  of  LI3NEW  should  be  the  same  one  used  when  it  was 
first  created.  LI3NEW  is  used  as  a read/write  library. 


These  three  library  description  commands  specify  two  libraries  during 
JAVS  processing.  There  are  five  combinations  of  library  commands  for  specifying 
JAVS  libraries. 


1.  CREATE  LIBRARY  = <name>. 

The  only  processing  step  for  which  LI3NEW  alone  Is  specified  is  3ASIC. 

The  overlay  version  of  JAVS  allows  this  library  command  to  be  used  in  multiple 
step  processing  without  additional  library  definition.  The  overlay  particulars 
are  described  along  with  other  machine  dependent  information  in  the  JAVS  User's 
Guide. 


2.  Or  D LIBRARY  = <name> . 

LI30LD  by  itself  is  used  whenever  no  new  information  is  to  be  added  to 
the  library.  It  can  be  used  in  any  processing  step  except  BASIC.  Processing 
steps  ASSIST,  DEPENDENCE  and  ANALYZER  use  this  Library;  INSTRUMENT  C3n 
use  LI30LD  and  save  the  instrumented  file  (LPUNCH)  on  disk.,  tape,  or  punched 
cards.  This  method  of  not  storing  the  instrumented  source  in  the  library  (by 


not  using  ALTER  or  CREATE  LIBRARY)  is  useful  if  the  library  is  already  large 
before  instrumentation. 

Although  LIBNEW  must  be  used  for  processing  subsequent  to  STRUCTURAL, 
there  may  be  instances  where  a preliminary  STRUCTURAL  run,  using  only  LIBOLD, 
is  desirable.  JAVS  printout  reflects  any  database  modifications  made  during 
a run;  however,  the  modifications  are  stored  only  on  LIBNEW  (the  read/write 
library).  Thus  LIBOLD  remains  unchanged. 

3.  ALTER  LIBRARY  = <name>. 

This  command  modifies  LIBNEW  and  saves  the  altered  library.  STRUCTURAL 
and  INSTRUMENT  data  are  often  saved  on  the  database  library  in  this  manner. 

4.  OLD  LIBRARY  = <name-l>. 

CREATE  LIBRARY  = <name-l>. 


This  set  of  library  commands  allows  the  creation  of  a new  library  by 
copying  the  contents  of  LIBOLD  for  the  specified  modules  onto  LIBNEW  and  then 
updating  LIBNEW  during  the  current  run.  LIBOLD  remains  unchanged. 

3.  OLD  LIBRARY  = <name-l>. 

ALTER  LIBRARY  = <name-2>. 


This  set  of  commands  differs  from  the  previous  combination  in  several 
respects:  (1)  LIBNEW  must  be  a previously  created  library,  (2)  for  the  specified 
modules  already  on  LIBNEW,  data  from  the  current  run  is  added  to  LIBNEW,  and 
(3)  modules  previously  only  on  LIBOLD  are  copied  onto  LIBNEW  and  updated  by 
the  current  run.  LIBOLD  remains  unchanged. 

Either  of  the  last  two  sets  of  library  description  commands  can  be  used 
in  any  processing  step  when  a library  merge  (see  Sec.  4.1.3)  is  desired.  They 
can  also  be  in  STRUCTURAL  and  INSTRUMENT  when  an  unchanged  library,  LIBOLD,  is 
desired  as  well  as  an  updated  LIBNEW. 

All  library  description  commands  must  precede  the  START  command. 


4.1.2  Library  Access  Command 

• DESCRIBE  = ON.  or  DESCRIBE  = OFF.  This  option  turns  ON  or 
OFF  a sequence  of  printouts  which  describe  in  detail  the 
access  interface  to  the  libraries.  The  default  is  OFF . 
This  option  is  intended  for  JAVS  maintenance.  The 
DESCRIBE  command  must  precede  the  START  command. 

4.1.3  Library  Process  Command 

The  MERGE  command  can  be  used  (1)  to  add  new  modules  to  an  existing  lib- 
rary, and  (2)  to  replace  old  modules  with  new  modules  having  the  same  module 
name  and  text  name.  The  command  is 

MERGE. 





4-5 


The  MERGE  command  merges  a LI30LD  vith  a LI3NEW.  After  merging  LI3NEW 
contains  all  modules  on  tne  original  Lj-SN'cI,  plus  all  modules  on  the  LI30LD 
that  do  not  have  the  same  module  name  and  text  name  as  a module  on  the  LI3NEW. 
3oth  LI30LD  and  LI3NSW  must  be  specified  in  one  of  the  two  sets  of  library 
description  commands  (see  Sec.  4.1.1). 

The  MERGE  command  must  be  preceded  by  the  START  command. 


4.2  STARTUP  COMMAND 


The  startup  command  terminates  the  library  description  and  indicates 
the  start  of  processing.  The  command  is 

START. 


and  causes  the  report  in  Fig.  4.1  to  be  printed, 
for  a description  of  the  items  in  this  report. 


See  command  END  in  Sec.  5 
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MODULE  SELECTION'  COMMANDS 


Many  JAVS  commands  require  specification  of  the  particular  module  upon 
which  computations  are  to  be  performed.  (Some  of  the  standard  print  commands 
require  this,  for  example.)  If  both  LI3NEW  and  LI30LD  have  been  declared,  the 
module  selector  will  first  Look  in  LI3NEW  for  the  module  and,  if  not  found, 
will  look  in  LI30LD.  Only  the  version  on  LI3NEW  will  be  selected  if  a module 
with  the  same  name  appears  on  both  libraries.  If  two  or  more  versions  of  a 
module  appear  on  a library,  the  last  one  entered  on  the  library  will  be 
selected. 

A module  is  identified  by  its  START-TERM  text  name  and  its  module  name. 
The  text  name  is  taken  from  the  JAVSTEXT  directive  which  appears  at  the  begin- 
ning of  the  START-TERM  text  sequence.  If  there  is  no  JAVSTEXT  directive,  the 
name  *XOJAVS*  is  automatically  supplied  by  3ASIC.  The  module  name  is  taken 
from  the  JOVIAL  statement  which  identifies  the  module  (e.g.,  program,*  PROC, 
CLOSE,  COMPOOL) . Only  the  first  eight  characters  of  the  name  on  the  JOVIAL 
statement  are  used  for  the  module  name.  The  first  eight  characters  of  the  name 
on  the  JAVSTEXT  are  used  as  the  text  name  (Sec.  1.4).  The  first  six  characters 
of  each  JAVSTEXT  on  the  library  must  be  unique. 


4.3.1  START- TERM  Text  Selection 

Some  JAVS  commands  require  specification  of  the  START-TERM  text  sequence 
upon  which  computations  are  to  be  performed.  START-TERM  texts  are  known  to 
JAVS  by  their  names.  The  following  command  makes  the  "current  text"  be  the 
named  one: 

JAVSTEXT  = <text-name>. 

All  subsequent  commands  (if  they  refer  to  a 
specified  text.  There  can  be  any  number  of 
JAVSTEXT=  command  replaces  and  supersedes  a 

4.3.2  Single  Module  Selection 

Modules  are  known  to  JAVS  by  their  names  and  the  text  to  which  they  belong. 
The  following  makes  the  "current  module"  within  the  "current  text"  be  the  named 
one : 


specific  text)  are  applied  to  the 
JAVSTEXT = commands . A new 
previous  JAVSTEXT*  command. 


MODULE  = <name>. 

All  subsequent  commands  (if  they  refer  to  a specific  module)  are  applied  to  the 
specified  module  within  the  "current  text."  If  no  "current  text"  has  been 
specified,  the  module  selector  will  locate  the  module  using  only  its  name. 

Thera  can  be  any  number  of  MODULE*  commands. 


Some  JOVIAL  compilers  require  that  the  main  program  be  specified  with  a 
PROGRAM  statement. 


^•3.3  Multiple  Module  Iteration 


r 


In  many  applications,  the  user  will  want  to  repeat  a command  for  a num- 
ber of  different  modules.  The  three  forms  of  command  iteration  structure 
are  described  below. 


4. 3. 3.1  Selected  Module  Iteration. 

The  following  sequence  selects  a number  of  modules,  by  name,  and  itera- 
tes a block  of  commands  (which  cannot  contain  another  iteration)  once  for 
each  specified  module: 

FOR  MODULE  = <name-l> , <name-2> , . . . , <name-n> . 

(any  set  of  commands) 

END  FOR. 

4. 3. 3. 2 ALL-Modules  Iteration  for  Specified  JAVSTEXT  (START-TERM  Text). 

The  following  sequence  selects  each  known  module  within  the  "current 
text  and  iterates  a block  of  commands  (which  cannot  contain  another  iteration) 
once  for  each  known  module  of  that  text: 

FOR  JAVSTEXT. 

(any  set  of  commands) 

END  FOR. 


4. 3. 3. 3  ALL-Modules  Iteration  for  Library. 

The  following  sequence  selects  each  known  module  on  the  library  and 
iterates  a block  of  commands  (which  cannot  contain  another  iteration)  once 
for  each  known  module: 

FOR  LIBRARY. 

(any  set  of  commands) 

END  FOR. 

4. 3. A Module  Selection  Constraint 

The  maximum  number  of  modules  which  may  be  specified  by  a single  itera- 
tion is  150  (see  Sec.  3). 
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4 . 4 


PROCESS  OPTION  COMMANDS 


Processing  seeps  3A3IC,  STRUCTURAL,  INSTRUMENT  and  ANALYZER  have  option 
con mands  which  define  the  action  taken  when  the  process  execution  command  is 
given.  The  option  commands  follow  the  START  command  and  precede  the 
appropriate  execution  command  (see  Sec.  4.5). 

4.4.1  3ASIC  lotion  Commands 


The  BASIC  options  are  specified  by  the  following  commands  (with  the 
defaulc  value  assumed  in  case  the  option  command  is  not  given  prior  to  the 
appearance  of  the  3ASIC  execution  command) : 


BASIC, CARD  IMAGES  = ON/OFF.  DEFAULT 
EASIC , COMMENTS  = ON/OFr.  DEFAULT 
3ASIC, DEFINES  = ON/OFF.  DEFAULT 
3ASIC, ERRORS  = ON/OFF/LIMIT/TRACE.  DEFAULT 
EASIC, SYMBOLS  = ON /OFF /PARTIAL.  DEFAULT 
BASIC, TEXT  = PRESET/COMPUTE/ 30TH/ JAVSTEXT.  DEFAULT 


ON. 


ON. 


ON. 


ON. 


PARTIAL. 


COMPUTE. 


3ASIC  options  which  have  been  selected  in  the  command  sequence  remain  in 
effect  until  they  are  reset  by  a later  command.  See  Sec.  5 for  a complete 
definition  and  example  of  each  3A3IC  option  command. 

The  user  will  note  that  module  selection  commands  do  not  apply  until 
after  a module  has  been  added  to  a librar”  ^urint?  SASIC  orocessing  by  the  BASIC 
verb.  The  name  assigned  to  a module  when  it  is  added  to  a library  is  the  first 
eight  characters  of  the  program  name,  procedure  name,  or  close  name  of  the 
module.  The  first  six  characters  of  the  names  should  be  unique. 

It  is  important  that  the  command  sequence  involving  one  or  more  occur- 
rences of  the  BASIC  execution  command  be  terminated  with  the  END  command  so  that 
LI3NEW  is  closed  properly.  The  user  may  employ  the  standard  print  and  punch 
commands  (Sec.  5)  af ter  the  BASIC  command  and  after  module  or  JAVSTEXT  speci- 
fication (Sec.  4.3). 


4.4.2  STRUCTURAL  Option  Command 

The  STRUCTURAL  print  option  is  specified  by  the  following  command  (with 
the  specified  default  value  assumed  in  case  the  command  is  not  given  prior  to 
the  appearance  of  the  STRUCTURAL  verb) : 

STRUCTURAL, PRINT  = SUMMARY /DEBUG.  (DEFAULT  = SUMMARY) 
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The  STRUCTURAL  option  which  has  been  selected  in  the  command  sequence  remains 
in  effect  until  it  is  reset  by  a later  option  command.  Each  instance  of  the 
STRUCTURAL  execution  command  in  a command  sequence  assumes  that  a module  has 
been  selected,  and  that  the  STRUCTURAL  execution  command  will  be  applied  only 
once  to  this  module. 

See  Sec.  5 for  a definition  and  example  of  the  STRUCTURAL  print  option. 
4.4.3  INSTRUMENT  Option  Commands 

The  INSTRUMENT  options  are  specified  by  the  following  commands  (with  the 
specified  default  value  assumed  in  case  the  command  is  not  given  prior  to  the 
appearance  of  the  INSTRUMENT  execution  command) : 


t 


V 

i 

! 


* 

1 


INSTRUMENT, MODE  = INVOCATION/DDPATHS/DIRECTIVES/FULL. 

DEFAULT  = DDPATHS . 

INSTRUMENT, PROBE, DDPATH  = <probe-name> . DEFAULT  = PROBE* 
INSTRUMENT, PROBE , MODULE  = <invocation-name> . 

DEFAULT  = PROBM* 

INSTRUMENT, PROBE, TEST  = <test-name>.  DEFAULT  = PROBI* 


INSTRUMENT  options  which  have  been  selected  in  the  command  sequence  remain  in 
effect  only  during  INSTRUMENT  processing  of  the  current  module.  Thus  if  the 
same  option  is  requested  for  a group  of  modules,  the  INSTRUMENT  option  and 
INSTRUMENT  execution  command  should  be  placed  within  the  module  selection  itera- 
tion (see  Sec.  4.3.3). 


4.4.4  ANALYZER  Option  Commands 

The  ANALY'ZER  options  are  specified  by  the  following  commands.  There  are 
few  default  options  for  ANALYZER,  since  most  option  commands  produce  one  or 
more  reports. 

Unlike  the  other  processing  steps,  ANALYZER  has  its  own  module  selection 
which  does  not  use  a JAVSTEXT  specification.  If  there  are  several  modules 
with  the  same  name,  but  with  different  JAVSTEXT  names,  coverage  reports 
should  be  specified  by  the  option: 


PROBE  is  an  arbitrary  name  used  for  the  DD-path  data  collection  routine. 
PROBM  is  an  arbitrary  name  used  for  the  module-invocation-and-return 
data  collection  routine. 

PROBI  is  an  arbitrary  name  used  for  the  tes t-beginning-and-test-end 
data  collection  routine. 

PROBD  is  an  arbitrary  name  for  the  description  writing  routine. 
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ANALYZER,  ALL  MODULES. 

If  not  all  of  che  Modules  were  ins trumented,  they  will  be  noted  as  "not  traced." 
The  ANALYZER,  options  are  of  the  following  format: 

ANALYZER, MODULE  = <name-L> , . . . , <nane-n> . 

ANALYZER, ALL  MODULES. 

ANALYZER, SUMMARY . 

ANALYZER, HIT. 

ANALYZER, NOTH IT. 

ANALYZE  R , MO  D LS  T . 

ANAL Y Z E R , MOD TRAC  E . 

ANALYZER, ddptrace . 

ANALYZER, TIME . 

ANALYZER , DDPATHS . 

ANALYZER, CASES  = <number>.  DEFAULT  = 10. 

ANALYZER,  FACTOR  = <percent  increase:-.  DEFAULT  = 0. 

ANALYZER, ALL. 


A description  and  example  for  each  option  is  given  in  Sec.  5. 


A. 5 PROCESS  EXECUTION  COMMANDS 


For  the  four  processing  steps  described  in  the  option  commands,  the  pro- 
cess execution  commands  are : 

BASIC. 

STRUCTURAL. 

INSTRUMENT. 

ANALYZER. 

Each  of  these  commands  causes  execution  of  the  processing  step  on  the  specified 
modules  (except  for  BASIC,  where  modules  are  not  specified)  according  to  the 
previously  specified  options  or  their  default  values. 

The  ASSIST  command  set  contains  only  execution  commands.  Module  selec- 
tion must  be  made  for  these  commands. 

ASSIST, REACHING  SET, <specif ications> . 

ASSIST, CROSSREF ,< specifications^ 

ASSIST, PICTURE [,<options>]  . 

ASSIST, STATEMENTS. 

The  DEPENDENCE  command  set  contains  only  execution  commands;  some  commands  re- 
quire module  specification  (see  Sec.  4.3.2)  and  some  commands  operate  on  the 
entire  library.  (See  Sec.  5 for  a detailed  description  of  each  command.)  All 
DEPENDENCE  commands  produce  a report  based  on  intermodule  dependencies. 

The  DEPENDENCE  module  commands  are: 

DEPENDENCE .PRINT , INVOKES . 

DEPENDENCE , BANDS  = <number>.  (DEFAULT  = 2) 

DEPENDENCE, TREE. 


4.6  STANDARD  PRINT  AND  PUNCH  COMMANDS 

4.6.1  PRINT 

The  standard  print  commands  provide  the  means  to  generate  formatted  ren- 
ditions of  JAYS  internal  tables.  These  print  commands  are  universal;  i.e., 
they  can  be  used  in  any  processing  step.  Ordinarily,  these  commands  are  use! 
after  STRUCTURAL  to  print  the  key  tables  generated  during  BASIC  and  STRUCTURAL. 
The  standard  print  commands  are  of  the  form: 

PRINT,  <table-name> . 

PRINT , JAVSTEXT=<name> [ , options  ] . 

where  <table-name>  is  DDP , DDPATHS , DMT,  MODULE,  SE,  SDB,  SLT,  STB  or  SYMTAB. 
For  a PRINT  table  to  be  accepted,  a module  must  have  been  selected  with  a 
module  selection  command  (see  Sec.  4.3.2).  The  PRINT  JAYSTEXT  commands  are 
used  to  display  the  START-TERM  text  as  it  is  presented  to  the  JOVIAL  compiler. 
The  options  specify  instrumented  or  uninstrumented  source  text. 

4.6.2  PUNCH 

The  standard  punch  commands  provide  the  means  to  generate  reformatted 
versions  of  the  source  text  in  preparation  for  the  JOVIAL  compiler.  The 
source  text  is  written  onto  file  LPUNCH  (see  Table  1.1  in  Sec.  1.1.3).  Tne 
standard  punch  commands  are  of  the  term: 

PUNCH , MODULE . 

FUNCH , JAYSTEXT=<name^ ; , options ' . 

The  PUNCH  MODULE  command  requires  module  selection  to  be  made  prior  to  the 
command.  Tne  JAYSTEXT  punch  command  is  used  to  prepare  the  complete  START- 
TERM  text  for  compilation.  The  options  specify  whether  the  text  is  tc  be  out- 
put to  LPUNCH  in  its  instrumented  or  uninstrumented  fort.. 

A complete  description  of  each  standard  print  and  punch  command  is  giver, 
in  Sec.  5. 


! 


->.7  RUN  TERMINATION  COMMAND 

A JAVS  run  terminates  on  Che  END  command,  which  provides  for  correccly 
closing  any  files  and  wricing  a wrapup  summary.  If  che  wrapup  report,  shown 
-n  rig.  1^  no c printed,  then  LI3Nr.N  was  not  closed  properly  and  cannot 

be  used  cn  subsequent  runs. 

The  run  termination  command  is 
END. 
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JAVS  COMMANDS 


Ik 


This  section  contains  a complete  list  of  JAVS  commands,  in  alphabetical 
order,  along  with  the  JAVS  processing  step  in  which  each  command  is  used. 

The  term  "universal"  indicates  that  the  command  can  be  used  in  any  processing 
step. * 

Following  the  list  of  commands  is  a description,  accompanied  with  sample 
output  and  command  sets,  of  each  JAVS  command. 


STEP 


JAYS  COMMANDS  (DEFAULTS  UXDEFLINEP) 

ALTER  LIBRARY  = <libr.a=e>. 

ANALYZER. 

ANALYZER,  ALL. 

ANALYZER , ALL  MODULES . 

ANALYZER,  CASES  = <nunber>. 

ANALYZER , DDPATHS . 

ANALYZER, DDPTRACE . 

ANALYZER, FACTOR  = <percent-increase> . 

ANALYZER, HIT. 

ANALYZER, MODLST . 

ANALYZER , MODTRACE . 

ANALYZER, MODULE  = <nan.e-l>  , <nar.e-2>  .... , <na=e-r.>  . 

ANALYZER, NOTHIT. 

ANALYZER , S UMMARY . 

ANALYZER, TIME. 

ASSIST, CROSSREF.JAVSTEXT  = <text-na=e-l> , <text-na=e-2> , . . . , 
<text-naae-n> . 

ASSIST,CROSSREF,LI3RARY. 

ASS I ST, PICTURE. 

ASSIST, PICTURE { ,CONTROL;{ ,NOS«TTCH: . 

ASSIST, REACHING  SET,<number-to>{  ,<nu=ber-f  rcc>  } 

{ .PICTURE { , ITERATIVE: } . 

AS SI ST, STATEMENTS. 


(Universal) 

ANALYZER 

ANALYZER 

ANALYZER 

analyzer 

ANALYZER 

ANALYZER 

ANALYZER 

ANALYZER 

ANALYZER 

ANALYZER 

ANALYZER 

ANALYZER 

ANALYZER 

ANALYZER 

ASSIST 

ASSIST 

ASSIST 

ASSIST 


ASSIST 

ASSIST 


BASIC. 

BASIC, CARD  IMAGES  = ON/OFF. 

BASIC, COMMENTS  = ON/OFF. 

BASIC, DEFINES  = ON/OFF. 

BASIC, ERRORS  = ON/OFF/LIMIT/TRACE. 

BASIC .SYMBOLS  = ON/OFF/PART IAL. 

BASIC, TEXT  = COMPUTE /BOTH/ PRESET /JAVSTEXT . 

* BUILD  LI3RARY  {=  < library  name> } , 

CREATE  LIBRARY  = <libname>. 

* i 

Can  be  used  only  with  the  overlay  version. 


BASIC 

BASIC 

BASIC 

3ASIC 

BASIC 

BASIC 

BASIC 

BASIC, 

STRUCTURAL 

(Universal) 
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JAVS  COMMANDS  (DEFAULTS  UNDERLINED) 


STEP 


DEPENDENCE, BANDS . 

DEPENDENCE, BANDS  = <number>. 

DEPENDENCE , GROUP , AUXLIB . 

DEPENDENCE , GROUP , LIBRARY . 

DEPENDENCE , GROUP .MODULES  = <name-l > , <name-2> , . . . , <name-n> . 
DEPENDENCE .PRINT , INVOKES . 

DEPENDENCE , SUMMARY . 

DEPENDENCE, TREE. 

DESCRIBE  = ON /OFF. 

♦DOCUMENT; , JAVS TEXT=< text -name >{ , MODULE' < name- 1>  , ...}}. 


END. 

END  FOR. 


DEPENDENCE 

DEPENDENCE 

DEPENDENCE 

DEPENDENCE 

DEPENDENCE 

DEPENDENCE 

DEPENDENCE 

DEPENDENCE 

(Universal) 

ASSIST, 

DEPENDENCE, 

(Universal) 

(Universal) 

(Universal) 


FOR  JAVSTEXT. 

FOR  LIBRARY. 

FOR  MODULE  = <name-l> , <name-2> , . . . , <name-n> . 


(Universal) 

(Universal) 

(Universal) 


INSTRUMENT. 

INSTRUMENT, MODE  = INVOCATION/DDPATHS /DIRECTIVES /FULL . 
INSTRUMENT, PRO BE, DDPATH  = <probe-name> . 

INSTRUMENT, PROBE, MODULE  = <invocation-name> . 

INSTRUMENT, PROBE, TEST  = <test-name> . 

INSTRUMENT, STARTTEST  = <modname> , < textname’ , <s tct . no.> 
{ ><TESNAM>}{  ,<TFLAG> } . 

INSTRUMENT , STOPTEST  = <modname> , < textname > , 

<stmt.  no.>. 


INSTRUMENT 

INSTRUMENT 

INSTRUMENT 

INSTRUMENT 

INSTRUMENT 

INSTRUMENT 


INSTRUMENT 


JAVSTEXT  = <text-name>. 


(Universal) 


MERGE. 

MODULE  = <name>. 


(Universal) 
(Universal ) 


OLD  LIBRARY  = <libname>. 


(Universal) 


Can  be  used  only  with  the  overlay  version. 
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JAVS  COMMANDS  DEFAULTS  UNDERLINED) 


STEP 


PRINT, DDP . 

PRINT, DDPATHS. 

PRINT, DMT. 

PRINT,  JAVS  TEXT  =>  <cexc-na:ae- L>,  INSTRUMENTED  = ALL. 

PRINT,  JAVS  TEXT  = < tax  C-naae  > , INSTRUMENTED  = <r.an;e-I>, 
<name-2>» . . . , <r.anie-a>. 

PRINT,  JAVSTEXT  = <cext-na:ne>. 

PRINT, MODULE. 

PRINT, 53. 

PRINT, SD3. 

PRINT , SLT . 

PRINT, ST3. 

*PR03E(, JAVSTEXT  = <texc-naae>{ .MODULE  = <nase-l>, . . . 

*PR03 1 , 3TARTTZ5T  = <ciodname>,  < cexcr.aae^ , <scnc . no  . > 

. , TESNAM ; { , TFLAG  ; . 

'•PR03I , STOPTEST  = <nsodnaae>,  <caxtnaae>,  <stac.  r.o.>. 
PUNCH,  JAVSTEXT  = < Cexc-nane* . 

PUNCH,  JAVSTEXT  = < text-r.ar.e>  , INSTRUMENTED  = ALL. 

PUNCH,  JAVSTEXT  = <text-na~e>  , INSTRUMENTED  = r.a-e-I>, 

<naae-2> , . . . , <name-n> . 

PUNCH, MODULE. 


(Universal) 


(Universal) 


(Universal) 


(Universal) 

(Universal) 


(Universal) 

(Universal) 

(Universal) 

(Universal) 

(Universal) 

(Universal) 

INSTRUMENT , 
(Universal) 

INSTRUMENT, 

(Universal) 

INSTRUMENT, 

(Universal) 

(Universal) 

(Universal) 

(Universal) 

(Universal) 


(S  Car cup) 

STRUCTURAL 

STRUCTURAL 


ANALYZER, 

(Universal) 


Can  be  used  only  wL ch  Che  overlay  version. 


S TART . 

STRUCTURAL. 

STRUCTURAL .PRINT  = SUMMARY /DEBUG. 

*TEST{ .MODULE  = <name-l> , <name-2> , . . . <name-n> } . 
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ALTER  LIBRARY  - <name> . 


ALTER  LIBRARY  = <name> . 


i 


- 


Description 

This  option  specifies  that  LIBNEV  is  a previously  generated  library  to 
be  modified  during  the  current  run.  LIBNEV  is  used  as  a read/write  library. 

Rule 

The  name  of  LIBNEV  must  be  the  same  one  used  when  it  was  first  created. 
Example  Command  Sets 

(1)  ALTER  LIBRARY  = REFMAN. 

START . 

FOR  LIBRARY. 

STRUCTURAL . 

END  FOR. 

END. 

This  command  set  will  modify  the  library  created  by  the  BASIC  processing 
step  and  add  the  STRUCTURAL  data  to  the  library  for  each  module  on  the 
library . 

(2)  ALTER  LIBRARY  = REFONE . 

START. 

BASIC. 

END. 

This  command  set  augments  a previously  built  library  with  the  BASIC  pro- 
cessing of  additional  source  text. 


r 


It 


1 

' 

j 
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ANALYZER. 


ANALYZER 


Rescript  ion 


The  ANALYZER  execution  command  causes  processing  of  the  post-test  analy- 
sis. If  no  ANALYZER  report  options  are  present,  no  report  is  produced. 

Rules 

For  a single  ANALYZER  command, 

(1)  Either  option  MCDTRACE  or  DDPTRACE  can  be  used,  but  not  both. 

(2)  A maximum  of  100  test  cases  is  analyzed. 

(3)  The  ANALYZER  command  ices  not  reposition  the  AUDIT  file;  thus 
consecutive  ANALY*-aR  commands  process  different  numbers  of  test 
cases,  dependent  upon  the  AN AL Y Z E R , CASES  command. 

Example  Command  Sets 


(1)  OLD  LIBRARY  = REFMAN. 
S TART . 

ANAL YZER, ALL  MO DULE 5 . 
ANALYZER , ALL . 
ANALYZER. 

END. 


This  set  of  commands  vill  produce  the 
DD PATHS , MODLST,  DDPTRACE  post-test  analysis 
library. 


UMMAR Y,  HIT,  NOTH IT,  TIME, 
reports  for  all  modules  on  the 


(2)  OLD  LIBRARY  = T REMAN . 

START. 

ANALYZER, CASES  = 50. 

ANALYZER, MODLTE  = EXPROGM, EXMPL1 , 
ANAL Y Z E R , S UMMA RY . 

ANALYZER, NOTHIT. 

ANALYZER, DDPATHS . 

ANALYZER, DDPTRACE . 

ANALYZER. 

END . 


o 
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ANALYZER, ALL.  ANALYZER, ALL . 


Description 

This  command  is  equivalent  to  the  following  set  of  commands: 

ANALYZER, SUMMARY. 

ANALYZER, HIT. 

ANALYZER, NOTHIT. 

ANALYZER, TIME. 

ANALYZER.DDPATHS. 

ANALYZER, MO DLST. 

ANALYZER, DDPTRACE. 

Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN1 . 

START. 

ANALYZER, MODULE  = EXPROGM, EXMPL1 . 

ANALYZER, ALL. 

ANALYZER. 

END. 

(2)  OLD  LIBRARY  = REFMAN1 . 

START . 

ANALYZER, ALL  MODULES. 

ANALYZER, CASES  = 100. 

ANALYZER, ALL. 

ANALYZER. 

END. 


ANALYZER . ALL  MODULES . 


ANALYZE?.,.' 


Description 


The  nodule 
LI30LD  for  which 
trace  file.  The 
nodules,  use  the 


specif icaticn  commands  are  used  to  identity  the  ~ 
ANALYZER  processes  the  summary  data  on  the  Test  l 
default  is  no  nodules  speciried.  To  specify  ail 
command : 


ANALYZER , -ALL  MODULES . 

To  specify  a subset  of  nodules,  use  the  cctnr.ar.d: 

ANALYZER, MODULE  = <name-l> ,<nane-2> <nane-n>. 


The  following  ANALYZER  options  require  nodule  specification 
HIT,  NOTHIT  , TIME,  MCDLST , DDPATHS,  .ALL. 


Example  Command  Sets 


(1)  OLD  LIBRARY  = REFTEST. 
START . 

ANALYZ ER , AL L MODULES . 
ANALYZER , ALL . 

•ANALYZER. 

END. 


(2)  OLD  LIBRARY  =*  REFMAN. 
START . 

ANALYZER, FACTOR  = 20. 

ANALYZER,  TIME. 

ANALYZER  , .ALL  MODULES  . 
ANALYZER . 

END. 


LL  MODULES . 


lodules  on 
'xe  cut  ion 
known 


: SUMMARY , 
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ANALYZER, CASES  - <number>. 


Description 

This  command  is  used  to  specify  the  maximum  number  of  test  cases  to 
process  from  the  test  file.  The  absence  of  this  command  specifies  the  default 
of  10  test  cases.  A test  case  is  determined  by  each  invocation  of  the  JAVS 
data  collection  routine  PROBI  with  the  second  parameter,  TFLAG,  equal  to  1,  2, 
or  3 (see  Sec.  2. 6. 2. 2).  ANALYZER  reads  and  analyzes  the  data  for  each  test 
case  encountered  on  the  test  file.  At  the  conclusion  of  the  specified  number 
of  test  cases,  or  at  the  end  of  the  last  test  case  if  less  than  the  number 
specified,  the  ANALYZER  reports  are  produced  and  all  further  analysis  of  the 
test  file  is  inhabited.  The  maximum  number  of  test  cases  which  ANALYZER  can 
process  is  100. 

Example  Command  Se t s 


(1)  OLD  LIBRARY  = REFMAN. 

START . 

ANALYZER, CASES  = 2. 

ANALYZER, SUMMARY. 

ANALYZER, MODULE  = EXMPL1 . 

ANALYZER. 

END. 

This  command  set  will  produce  the  post-test  summary  report  for  only  the 
first  two  testcases  for  module  EXMPL1,  even  if  there  are  more  than  two  test 
cases  on  the  test  file. 

(2)  OLD  LIBRARY  = REF. 

START. 

ANALYZER, CASES  «=  100. 

ANALYZER, ALL  MODULES. 

ANALYZER, ALL. 

ANALYZER . 

END. 

This  command  set  raises  the  number  of  allowable  test  cases  from  the 
default  of  10  to  the  maximum  limit  of  100. 


r 

ANALYZER,  CASES  ■=  <number>. 


! 


i 
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AN AL  Y Z E R , D D PATHS , 


ANALYZER, DDPATHS , 


. - * 


Ascription 


For  each  specified  nodule,  this  command  causes  ANALYZER  to  produce  a 
source  listing  for  the  statements  which  begin  a DD-path,  showing  the  DD-path 
description  and  an  execution  count  reflecting  DD-path  coverage  for  all  test- 
cases  encountered  on  the  trace  file.  The  report  is  similar  in  format  to  the 
report  from  PRINT,  DDPATHS,  with  execution  counts  appended.  DD-path  coverage 
is  summarized  at  the  end  of  the  report.  If  a specified  nodule  is  not  invoked 
during  the  test,  this  report  is  suppressed. 

Samole  Cutout 
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ANALYZER, DDPATHS.  (Cont.) 


Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN. 

START. 

ANALYZER, ALL  MODULES. 

ANALYZER, DDPATHS. 

ANALYZERjMODLST. 

ANALYZER. 

END. 

This  command  set  will  produce  only  the  two  cumulative  coverage  reports, 
DD-path  coverage  and  statement  coverage,  from  the  set  of  test  cases  on  the 
trace  file. 

(2)  OLD  LIBRARY  = REFMAN. 

START. 

ANALYZER, MODULE  = EXAMPL1 . 

ANALYZER, DDPATHS . 

ANALYZER, NOTHIT . 

ANALYZER. 

END. 


This  command  set  will  produce  the  DD-path  cumulative  coverage  report  and 
the  test-by-test  report  of  DD-paths  not  executed  for  module  EXMPL1. 


1 


ANAL YZSR , DDPT'RACE . 

description  Lf  - 

This  command  causes  a printout  of  the  Test  Execution  trace  data  at  the 
DD-path  level  with  the  nodule  invocation  and  return  trace  data  interspersed. 
The  trace  data  must  have  been  recorded  at  the  DD-path  level;  i.e.,  the  TFLAG 
parameter  in  the  PROBI  call  must  be  3.  Each  line  of  output  represents  a 
nodule  invocation  or  return,  the  start  of  a execution,  or  the  beginning  or  end 
of  a test  case  or  test  set.  Each  DD-path  line  shows  the  DD-path  number,  its 
description  and  outcome,  and  the  relevant  source  text.  (The  FOR  statement  is 
considered  to  be  the  relevant  statement  in  iteration.) 


ANALYZER .DDPTRACE . 


Rule 

FaV  a single  ANALYZER  command,  either  option  ZD? TRACE  or  MODTRACE  can 
be  used,  but  not  both. 

Samole  Outout  Excerpt 
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Example  Command  Set 


•OS-PAT-  2 
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OLD  LIBRARY  = REFMAN. 

START . 

ANALYZER, ALL  MODULES. 

ANALYZER, DDPTRACE. 

ANALYZER, DDPATHS. 

ANALYZER. 

END. 

This  command  set  will  produce  the  DD-path  trace  report  and  the  cumula- 
tive DD-path  coverage  report  for  all  modules  on  the  library. 
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ANALYZER, FACTOR  = <percent>. 


ANALYZER, FACTOR  = <percent>. 


Description 

This  command  is  used  in  conjunction  with  the  ANALYZER, TIME,  option.  It 
allows  the  user  to  establish  a value  for  the  estimated  CPU  time  overhead  of 
executing  the  inserted  probe  statements  in  instrumented  modules. 

In  the  report  produced  by  the  command 

ANALYZER, TIME. 

both  the  actual  time  including  the  inserted  probe  statements  and  the  estimated 
time  using  the  <percent>  specified  is  shown.  Absence  of  the  ANALYZER .FACTOR 
option  command  indicates  no  overhead  in  the  time;  i.e.,  the  default  is  0 
percent . 

Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN . 

START. 

ANALYZER, FACTOR  - 20. 

ANALYZER, TIME. 

ANALYZER, ALL. 

ANALYZER, ALL  MODULES. 

ANALYZER. 

END. 

(2)  OLD  LIBRARY  = REFMAN. 

START. 

ANALYZER, ALL  MODULES. 

ANALYZER, FACTOR  = 10. 

ANALYZER, TIME. 

ANALYZER. 

END. 
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ANALYZER, HIT 


ANALYZER, HIT. 


Description 

This  command  causes  ANALYZER  to  produce  a list  of  DD-paths  tor  each 
nodule  and  the  number  of  tines  each  path  has  been  traversed.  Tvo  such  lists 
are  made:  one  for  each  test  case  and  one  for  all  test  cases  analyzed.  Only 
the  nodules  specified  by  an  ANALYZER  nodule  selection  option  and  encountered 
on  the  AUDIT  file  will  be  represented  in  this  report. 

Sacra  le  Cutout 
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Single  Test  Case 
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Multiple  Test  Cases 


Example  Connand  Set 

OLD  LIBRARY  = REFMAN. 
START. 

ANALYZER , ALL  MODULES . 
ANALYZER, HIT. 
ANALYZER. 

END. 


ANALYZER. MODLST . 


ANALYZER, MODLST. 


Description 

This  command  causes  ANALYZER  to  print  a source  listing  of  each  specified 
module  which  shows  the  number  of  times  each  executable  statement  was  exer- 
cised for  all  testcases.  The  DD-paths  are  listed  at  the  right  of  the  state- 
ment of  origin.  Next  is  a count  of  the  times  each  executable  statement  was 
exercised;  executable  statements  not  exercised  are  flagged  with  an  asterisk. 

To  the  far  right  are  control  indicators  for  statement  types  which  affect  nor- 
mal processing  sequence.  Statement  coverage  is  summarized  at  the  end  of  the 
module  listing.  If  a specified  module  is  not  invoked  during  the  test,  this 
report  is  suppressed. 
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ANALYZER.MCPLST.  (Cont.) 


Example  Coir.i-.ar’.d  Sec 

OLD  LIBRARY  = REFMAN. 

ANALYZES,  MODULE  = EXPROGM, EXMPL1 . 
ANALYZER, MODLST. 

ANALYZER. 

END. 


ANALYZER, MODTRACE. 


ANALYZER , MO DTRACE ■ 


Description 

This  command  causes  a printout  of  the  Test  Execution  trace  data  at  the 
module  invocation  and  return  level.  If  the  trace  data  was  not  recorded  on 
the  file  during  Test  Execution  (see  Sec.  2. 6. 2. 2),  no  report  is  produced.  Each 
line  of  output  represents  either  a module  invocation  or  the  beginning  or  end 
of  a test  case  or  test  set.  The  level  of  invocation  for  the  modules  being 
traced  is  shown  to  the  left;  the  module  invocations  are  indented  to  show  nest- 
ing level. 

Rule 


For  a single  execution  of  ANALYZER,  either  option  MODTRACE  or  DDPTRACE 
can  be  used,  but  not  both. 

Sample  Output 
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Sample  Command  Sets 


(1)  OLD  LIBRARY  = REFMAN. 
START . 

ANALYZER, MODTRACE . 
ANALYZER. 

END. 

(2)  OLD  LIBRARY  = REFMAN. 
START . 

ANALYZER, MODTRACE . 
ANALYZER, ALL  MODULES. 
ANALYZER, SUMMARY. 
ANALYZER. 

END. 
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ANALYZER , NOTHIT . 


ANALYZER, NOTHIT . 


Description 

This  command  causes  ANALYZER  to  list  any  DD-path  which  was  not  traversed 
in  each  test  case  and  all  test  cases  for  the  specified  modules.  If  a module 
was  not  invoked  during  any  test  cases,  not  probed  during  INSTRUMENT,  or  not 
specified  for  ANALYZER  processing,  it  will  not  be  referenced  in  this  report. 

Sample  Output 
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Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN. 

START. 

ANALYZER, MODULE  = EXPR0GM.EXMPL1 . 
ANALYZER, NOTHIT. 

ANALYZER. 

END. 

(2)  OLD  LIBRARY  = REFMAN. 

START. 

ANALYZER, ALL  MODULES. 

ANALYZER , SUMMARY . 

ANALYZER, NOTH IT. 

FOR  LIBRARY. 

PRINT, DDP. 

END  FOR. 

END. 


This  command  set  will  provide  the  post-test  analysis  coverage  summary, 
the  list  of  DD-paths  not  executed  in  any  of  the  test  cases,  and  the  list  of 
statements  on  each  DD-path  for  all  modules  in  the  library. 
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AIJALY2ER , SUMMARY . 


When  this  option  is  specified,  a report  is  produced  which  summarizes  the 
testing  coverage  of  each  of  the  specified  nodules  for  each  test  case  encoun- 
tered on  the  saved  trace  file  and  for  the  cumulative  of  all  tests  completed  in 
the  run.  Included  in  the  report  is  the  list  of  modules  selected  but  not  in- 
voked during  any  of  the  tests  in  the  run.  The  cumulative  coverage  shown  on 
the  last  line  is  adjusted  to  reflect  all  selected  modules. 

Sample  Output  Excerpt 
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ANALYZER, SUMMARY.  (Cont.) 

)' 

Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN.  ' 

START . 

ANALYZER, ALL  MODULES. 

ANALYZER, SUMMARY. 

ANALYZER. 

END. 

(2)  OLD  LIBRARY  = REFMAN. 

START. 

ANALYZER, MODULE  = EXPROGM.EXMPLl . 
ANALYZER, SUMMARY. 

ANALYZER. 

END. 


i 
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ANALYZER, TIME. 


Descriotion 


r,.T  at  ’ * ||  ' ' 

r f A 

n.Kj  a • ..  >,  v. 

..L. 

ANALYZER. TIME. 


This  command  causes  -ANALYZER  to  print  a summary  of  the  time  spent  in 
execution  within  the  specified  modules  for  all  tests.  Only  complete 
invocation-return  cycles  are  included  in  the  time  reported  (i.e.,  the  incre- 
ment of  time  added  for  each  cycle  to  the  cumulative  execution  time  for  a mod- 
ule is  the  time  interval  logged  by  the  system  clock,  between  the  invocation  of 
the  module  and  the  next  return  from  the  module,  excluding  time  spent  in  the 
data  collection  routines). 


The  TIME  report  lists  all  specified  modules,  even  though  some  modules 
not  have  been  invoked  or  instrumented  (denoted  by  NOT  TRACED). 
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.e  :ut 
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i i 

NOT  TBACtO 


In  this  sample  output,  the  estimated  time  reflects  an  ANALYZER,  FACTOR  = 
20.  command  accompanying  the  TIME  report  command.  In  this  case  20 7,  of  the 
actual  execution  time  is  subtracted  from  the  values  listed  under  execution 
time  and  these  reduced  values  are  listed  as  the  estimated  execution  time.  The 
execution  time  spent  in  EXPROOM  (171  ms)  includes  the  26  ms  spent  in  EXMPL1, 
since  EXMPL1  is  nested  within  EXPROGM. 


Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN. 
START . 

ANALYZER, ALL  MODULES . 
ANALYZER, FACTOR  = 20. 
ANALYZER, TIME . 
ANALYZER, SUMMARY. 
ANALYZER. 

END. 

(2)  OLD  LIBRARY  = REFMAN. 
START . 

ANALYZER, ALL  MODULES . 
ANALYZER, TIME. 
ANALYZER, CASES  = 75. 
ANALYZER. 

END. 


ANALYZER. TIME.  (Cont.) 


In  the  second  command  set,  no  attempt  was  made  to  estimate  the  time 
spent  executing  the  probe  invocation  statements;  thus  the  execution  and  esti- 
mated time  value  will  be  identical. 
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ASSIST, CROSSREF. LIBRARY 


ASSI ST, CROSSREF. LIBRARY. 


Description 


The  outcome  of  this  command  is  a cross-reference  listing  of  names  in  the 
entire  library  and  their  usage.  The  names  listed  are  all  items,  files,  switch 
names,  labels,  and  subprogram,  names. 

Rules 

(1)  A maximum  of  100  JAVSTEXTs  can  be  used  in  cross  reference  mapping. 

(2)  A maximum  of  125  modules  can  be  used  in  cross  reference  mapping. 
Sample  Output  Excerpt 
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33 

Example  Command  Set 

OLD  LIBRARY  «=  REFMAK . 
START. 

ASSIST, CROSSREF, LIBRARY. 
END. 
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ASSIST, PICTURE. 

Description 

There  are  two  forms  of  this  command: 

ASSIST, PICTURE,  or 

ASSIST .PICTURE , <op tion-l> , <op t ion-2' . 
where  option-1  is  CONTROL  and  option-2  is  NOSWITCH. 

This  command  produces,  for  the  specified  module,  a stylized  picture  of 
the  pattern  of  program  flow  implicit  in  the  set  of  sequence  of  DD-paths.  The 
available  options  are  CONTROL  and  NOSWITCH.  If  CONTROL  is  present,  the  pic- 
ture includes  all  control  statements  (e.g.,  GOTO,  invocation)  on  the  DD-path. 
If  NOSWITCH  is  present,  the  picture  omits  the  flows  emanating  from  GOTO-switch 
statements . 

Each  line  in  the  picture  represents  a statement  at  the  beginning  of  a 
DD-path  or  a control  statement;  the  statement  type*  and  number  are  displayed 
in  the  center.  Each  DD-path  is  represented  by  either  a 3 -*■  E sequence  or  an 
S.  The  B — E sequence  shows  where  the  DD-path  3_egins  and  Ends;  the  S indi- 
cates that  the  DD-path  begins  and  ends  on  the  same  statement.  The  statements 
shown  are  those  which  are  "necessary"  to  display  all  possible  program  flow 
and,  by  convention,  are  arranged  in  statement  order.  All  "forward  flow" 

(with  respect  to  the  statement  ordering)  is  shown  by  convention  on  the  right- 
hand  side  of  the  picture;  and  all  "reverse  flow"  is  shown  in  the  left-hand 
side.  For  those  statements  which  are  at  the  beginning  of  a DD-path,  the  num- 
ber of  the  DD-path  is  specified  on  the  far  right  margin.  The  DD-path  numbers 
are  ordered  left  to  right.  Control  statements  are  indicated  by  a C . 

For  very  complex  modules  (e.g,,  switches  with  a large  number  of  targets) 
the  NOSWITCH  format  limits  the  number  of  paths  which  can  be  displayed.  If  the 
picture  overflows  on  the  right  or  left  side,  an  informative  message  is  printed 
and  processing  continues. 


ASSIST, PICTURE. 


ASSIST, PICTURE.  (Cont.) 


i 


Sample  Output 
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Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAK. 

START. 

MODULE  = EXMPL1 . 

ASSIST, PICTURE , CONTROL . 

END . 

This  command  set  produced  the  sample  output. 

(2)  OLD  LIBRARY  = REFMAN. 

START. 

FOR  LIBRARY. 

ASSIST, PICTURE. 

END  FOR. 

END. 

This  command  set  would  produce  a picture  for  each  module  on  the  library 
similar  to  the  one  in  the  sample  output,  but  without  the  control  statements 
(GTCL  29  in  the  sample  output)  displayed. 

(3)  OLD  LIBRARY  = REFMAN. 

START. 

JAVSTEXT  = EXPROGM. 

FOR  JAVSTEXT. 

ASSIST, PICTURE, CONTROL, NOSWITCH. 

END  FOR. 

END. 
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ASSIST, PICTURE.  CCont . ) 


In  addition  to  the  control  statements'  being  displayed,  this  command 
set  will  omit  the  flows  and  TD-path  numbers  emanating  from  GOTO-svitch  state- 
ments (GTSW  28,  DD-paths  7 to  11  in  the  sample  output). 

(4)  OLD  LIBRARY  = REFMAN. 

START . 

MODULE  = EXMPL1 . 

ASS I ST , PICTURE , NOSWITCH . 

END. 

The  picture  options  need  not  be  in  order. 


V 


ASSIST, REACHING  SET , <specs> ■ 


AS SI ST, REACHING  SET,<specs>. 


j 


■ 


i 


Description 


This  command  is  used  to  analyze  the  flow  required  to  reach  a particular 
DD-path  according  to  the  items  in  the  specification  list.  The  reaching  set 
consists  of  all  DD-paths  which  flow  between  the  beginning  and  ending  DD-paths 
There  are  three  types  of  specifications  (which  may  be  present  in  any  order  bu 
separated  by  commas): 

<number-to> { , <number-f rom> } 

ITERATIVE 


PICTURE 


The  DD-path  for  the  reaching  set  (i.e.,  the  target  of  flow)  is  named  by 
the  (required)  specification  <number-to*.  In  the  absence  of  a <number-f rom> 
specification,  the  flow  is  assumed  to  start  with  the  first  executable  state- 
ment. The  <number-f rom>  specification  allows  the  user  to  designate  the  DD- 
path  where  flow  starts.  The  analysis  begins  with  the  first  executable  state- 
ment on  the  DD-path. 

The  (optional)  ITERATIVE  specification  allcvs  the  user  to  control  the 
set  of  DD-paths  in  the  analysis.  If  ITERATIVE  is  not  specified,  all  flows 
which  include  iteration  are  suppressed  in  determination  of  paths  of  ccr.trcl. 
If  ITERATIVE  is  specified,  the  flows  include  iteration. 

The  (optional)  PICTURE  specification  allows  the  user  to  control  the 
additional  reports  presented.  If  PICTURE  is  not  present,  the  output  is 
limited  to  the  reaching  set  definition.  The  additional  picture  report  shown 
in  the  sample  output  is  included  as  a result  of  the  command 


ASSIST, REACHING  SET , 1 7 , 4 ,P I CTURE . 


Rules 

(1)  Maximum  of  100  DD-paths  per  reaching  set  path. 

(2)  Maximum  of  100  outways  per  decision. 

(3)  Maximum  of  1200  DD-paths  per  analyzed  module  for  reaching  set. 

(4)  Maximum  of  2400  statements  per  analyzed  module  for  reaching  set. 

(5)  Maximum  of  200  statements  in  reaching  set. 
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ASSIST, REACHING  SET  <specs> . (Cont.) 


Satiple  Output 
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Reaching  Set  Detiniticn 
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Picture  of  Reaching  Set 


AS SI ST. REACHING  SET,<specs>.  (Cont . ) 


Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN. 

START . 

JAVSTEXT  = EXPROGM. 

MODULE  *=  EXMPL1. 

AS S I ST , REACHIN G SET , 1 6 , ITERATIVE , P I CTURE . 

END. 

This  command  set  will  produce  the  reaching  set  definition  and  reaching 
set  picture  reports  containing  all  DD-paths,  including  iteration,  which  flow 
between  DD-path  1 and  DD-path  16  of  module  EXMPL1. 

(2)  OLD  LIBRARY  = REFMAN. 

START . 

JAVSTEXT  = EXPROGM. 

MODULE  = EXMPLl . 

ASSIST .REACHING  SET, 17, 4. 

END. 

This  command  set  produces  the  first  report  shown  ih  the  sample  output. 


ASSI ST .STATEMENTS. 


ASSIST , STATEMENTS . 


Description 

This  command  produces  a report  describing  the  DD-path  membership  for 
each  executable  statement  in  the  "current  module."  The  statements  are  listed 
in  statement  order  with  their  type,  the  DD-path  numbers  which  begin  on  the 
statement,  and  the  complete  set  of  DD-paths  which  contain  the  statement.  A 
DD-path  beginning  or  ending  is  represented  by  a 3 or  E. 

Sample  Output 

jr»re»CNT/oop*TH  listino 

■ooule  >#  javsteit  <expaoG«  >#  papcnt  woouie  » 

DD-PAT-«S  9E3UN 


*T 

TfP£ 

97  STaT£*£nT 

0P-»»T 

*5  CONTAINING 

STATEMENT 

l 

P30C 

< 1 ) 

1 3 

2 

9€5N 

1 

9 

rp 

( 2- 

3) 

\€ 

28 

38 

19 

AS*r 

2 

1 1 

as 

2 

3 

12 

t . p 3 

2 

3 

1 9 

1 3 

91  »N 

2 

3 

19 

15 

2 

3 

1 9 

1 6 

AS-r 

2 

3 

19 

1 9 

f:q3 

2 

3 

IT 

19 

19 

9t  j*4 

2 

3 

t 7 

19 

21 

!pp  I 

( 4- 

5) 

2£ 

3E 

48 

58  1 7£ 

22 

AS**  T 

4 

23 

Q9!p 

( 6) 

5E 

68 

24 

ASMT 

6 

25 

£Sn 

A 

6 

29 

3TS« 

( 7- 

1 1 ) 

4£ 

6E 

79 

98  98 

29 

3*  cl 

19 

1 1 

39 

hei 

( 12- 

131 

7£ 

8E 

9C 

13C  ne 

31 

AS  **T 

12 

32 

OJJP 

( 14- 

15) 

13E 

1 40 

158 

33 

AS**T 

14 

34 

C*tp 

( 16) 

15£ 

168 

35 

AS“T 

16 

36 

£Sf> 

12 

14 

1 6 

39 

OuTP 

12 

14 

16 

39 

£%  0 

< 1 r» 

HI 

12C 

I a£ 

!6£ 

178  188 

41 

£s(9 

1 19- 

20) 

1 9£ 

198 

238 

44 

ENO 

20C 

138  118 

129  1 38 


Exaaole  CoTtziand  Set 


OLD  LI3RARY  = REFMAN. 
START. 

JAVSTEXT  = EXPROGM. 
MODULE  = EXMPL1. 
ASSIST , STATEMENTS . 
END. 


BASIC. 


BASIC. 


Description 

The  BASIC  command  causes  BASIC  syntax  analysis  to  be  executed.  The 
actions  performed  by  the  BASIC  command  are: 

1.  To  build  LIBNEW  containing  a module  descriptor  block,  a statement 
descriptor  table,  a statement  table,  a symbol  locator  table,  and  a 
symbol  table  for  each  module  in  each  START-TERM  sequence  on  the 
INPUT  file. 

2.  To  produce  a report  indicating  the  source  text  of  each  module, 
the  module  name,  and  a count  of  the  syntax  and  semantic  errors 
detected  in  the  source  for  each  START-TERM  sequence. 

A sample  report  is  shown  below.  This  report  contains  the  following 

items : 

• A listing  of  the  original  source  text  with  the  errors  encountered 
in  BASIC  analysis  interspersed. 

• Summary  information  at  the  end  of  each  module  and  each  START-TERM 
sequence . 

Rules 


(1) 

See  BASIC 

constraints 

in  Sec. 

3.2. 

(2) 

Maximum  of 

250  modules 

can  be 

on  LIBNEW 

(3) 

Maximum  of 

150  modules 

in  any 

JAVSTEXT. 
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BASIC . (Cone.) 
Sample  Output 
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9EG I n 

ITEPI  * IS 
PEP?  « IS 
CNO  F#EX«*PL2F* 


C*MPt?  ( £ i PPOGM  ) COMP'.ETEO 


Example  Command  Sets 


(1)  CREATE  LIBRARY  = REF MAN . 

START. 

3ASIC. 

END. 

This  command  set  will  cause  library  REFMAN  to  be  built  containing  the 
syntax  analysis  for  the  input  source  text.  All  BASIC  default  options  are  used 
in  this  command  set,  and  the  sample  output  will  be  produced. 
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BASIC.  (Cont.) 


J 


' 

: 


; 


(2)  CREATE  LIBRARY  = REFMAN. 

START. 

BASIC, CARD  IMAGES  = OFF. 

BASIC. 

FOR  LIBRARY. 

PRINT, MODULE. 

END  FOR. 

END. 

This  command  set  will  perform  syntax  analysis  on  the  input  source  text, 
create  the  library,  print  an  abbreviated  report,  and  then  print  the  refor- 
matted listing  for  each  module  on  the  newly  created  library. 


it 


3ASIC , CARD  IMAGES  = <option>.  BASIC, CARD  IMAGES  = <option>. 

Oescription 

BASIC .CARD  IMAGES  = ON/OFF.  (DEFAULT  = ON.) 

This  command  allows  user  control  over  the  inclusion  of  the  source  text 
j listing  in  the  report  produced  by  3ASIC  processing.  The  effect  of  the  option 

command 

3 ASIC, CARD  IMAGES  = OFF. 


on  the  3ASIC  output  is 

shown  below 

; only  summary  information 

Sample  Output 

EXCOMPL 

(Excompl  i 

completed 

• • * 

ERRORS  «ERE 

POUND 

BY 

J4VS-? 

E*MPU2 

(E»PPOGX  ) 

COMPLETED 

EXMPL3 

iE*PPOGM  j 

COMPLETED 

exmpli 

(EXPwOGM  ) 

COMPLETED 

EXPPOGM 

(Ex&hog*  ) 

COMPLETED 

• •• 

ERRORS  "ERE 

POUND 

BY 

JAVS-? 

Example  Command  Set 


CREATE  LI3RARY  = REFMAN. 
START . 

BASIC, CARD  IMAGES  = OFF. 
BASIC. 

END. 
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BASIC , COMMENTS  = <option>. 


BAS I C , COMMENT S - <option>. 


Description 

BASIC, COMMENTS  = ON /OFF.  (DEFAULT  = ON . ) 

This  command  allows  user  control  over  the  treatment  of  comments  in  the 
module  source  text.  The  default  action  is  to  include  all  comments  in  the 
library.  Comments  may  be  excluded  from  the  statement  text  table  of  all 
modules  by  the  command 

BASIC, COMMENTS  = OFF. 

If  comments  are  included,  more  space  is  required  on  the  library  and  all  subse- 
quent processing  of  the  statement  table  requires  more  computer  time.  Comments 
should  be  excluded  from  the  library  if  they  are  imbedded  within  JOVIAL 
statements. 

Sample  Command  Set 

CREATE  LIBRARY  = REFMAN. 

START. 

BASIC, COMMENTS  = OFF. 

BASIC. 

END. 


* 

k- 

i 

i 

kl 
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* 

; 


I 


J 


3A5IC, DEFINES  = <option>. 


<ootion> . 


3ASIC, DEFINES  = 


Oesci  iotion 


SASIC, DEFINES  = ON/OFF.  (DEFAULT  = ON.) 

This  command  allows  Che  user  control  over  BASIC  usage  of  DEFINE  vari- 
ables. The  default  option  is  to  replace  the  occurrence  of  each  DEFINE  vari- 
able with  its  definition  just  as  the  JOVIAL  compiler  does.  Subsequent  BASIC 
processing  utilizes  the  results  of  that  definition  both  in  statement  analysis 
and  in  the  text  stored  for  each  statement  on  the  library.  It  is  essential 
that  the  default  option  be  used  if  the  modules  are  to  be  processed  by  any 
other  JAVS  standard  processing  step. 

Replacement  of  DEFINE  variables  by  their  definition  may  be  suppressed 
with  the  command: 

BASIC .DEFINES  = OFF. 

This  command  is  normally  used  only  when  the  following  commands  are  also  used: 
BASIC, ERRORS  = OFF. 

BASIC, TEXT  = JAVSTEXT. 

Text  so  processed  may  be  written  to  LPUNCH  in  the  structured  format  with  the 
command : 

PUNCH, JAVSTEXT  = <text-name>. 

This  is  useful  in  using  JAVS  to  punch  a copy  of  reformatted  source  text.  To 
get  a reformatted  listing  of  the  source  text,  the  PRINT, JAVSTEXT  command  can 
be  used. 
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BASIC, ERRORS  = <option>. 


BASIC, ERRORS  = <option>. 


Description 


BASIC .ERRORS  = ON/OFF/LIMIT/TRACE.  (DEFAULT  = OK.) 

This  command  allows  the  user  control  over  the  syntax  and  semantic  errors 
detected  in  the  JOVIAL  source  by  BASIC.  ^The  default  option  prints  a numbered 
error  message  as  each  error  is  detected.  These  error  messages  are  inter- 
spersed in  the  list  of  source  text  lines  (CARD  IMAGES  = OK.).  Since  BASIC 
processing  scans  the  JOVIAL  source  text  only  once,  not  all  source  errors  are 
detected. 

All  error  messages  may  be  suppressed  by  the  command 
BASIC, ERRORS  = OFF. 

The  number  of  errors  may  be  limited  by  the  command 
BASIC, ERRORS  = LIMIT. 

For  this  option,  when  the  number  of  errors  exceeds  100,  BASIC  terminates  pro- 
cessing immediately  and  a fatal  JAVS  error  results. 

In  addition  to  the  error  message  itself,  the  origin  of  the  error  in  the 
JAVS  code  can  be  displayed  with  the  command 

BASIC, ERRORS  = TRACE. 

This  is  useful  in  JAVS  system  maintenance. 

Sample  Command  Set 

CREATE  LIBRARY  = REFMAN. 

START. 

BASIC, CARD  IMAGES  = OFF. 

BASIC, ERRORS  = OFF. 

BASIC. 

END. 


* 


See  Appendix  B for  a description  of  BASIC  error  messages. 
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BASIC , 5VM30LS  - <option>. 


SASIC , SYMBOLS  = <option>. 


Description 


3ASIC,SYM30LS  = CM/ OFF/ PARTIAL . (DEFAULT  = PARTIAL.) 

This  command  allows  the  user  control  over  the  symbols  entered  in  the 
detailed  symbol  table.  The  default  action  is  to  enter  only  those  symbols 
essential  to  other  JAVS  processing  steps.  These  symbols,  called  control  sym- 
bols, are  the  names  of  modules,  statement  labels,  and  switches. 

Other  JOVIAL  identifiers  and  constants  may  be  included  in  the  symbol 
table  with  the  command 

3 ASIC, SYMBOLS  = ON. 

3ASIC  performs  a limited  analysis  on  the  properties  of  each  symbol  and  stores 

type-dependent  information  about  each  in  the  symbol  table.  More  space  is 

required  on  the  library  for  the  additional  symbol  table  entries  and  all  sub- 
sequent processing  of  the  symbol  table  requires  more  computer  time. 

The  symbol  table  may  be  omitted  from  the  library  with  the  command 

3ASIC , SYM30LS  = OFF. 

This  option  is  meaningful  only  if  the  library  is  never  processed  by 

STRUCTURAL  and  subsequent  JAVS  processing  steps  (e.g.,  when  just  BASIC  pro- 

cessing is  used  to  reformat  the  source  text) . 

Sample  Command  Set 

CREATE  LI3RARY  = REFMAN. 

START . 

3ASIC, SYMBOLS  = ON. 

3ASIC . 

FOR  LIBRARY. 

PRINT, STB. 

END  FOR. 

END. 

This  command  set  will  put  all  symbols  on  the  newly  created  library  and 
then  print  the  symbol  table  for  each  module. 
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BASIC, TEXT  = <option> ■ 


BASIC, TEXT  = <option>. 


Description 


BASIC, TEXT  = COMPUTE /BOTH /PRESET/ JAVSTEXT . (DEFAULT  ■=  COMPUTE . ) 

This  command  allows  the  user  control  over  the  type  of  analysis  performed 
by  BASIC  on  the  sets  of  START-TERM  text  appearing  on  the  file  INPUT.  BASIC 
processes  a sequence  of  START-TERM  texts  until  an  end-of-file  is  detected  on 
READER.  Three  types  of  text  sequences  are  permitted: 

1.  One  or  more  START-TERM  texts  of  executable  (COMPUTE)  source. 

2.  A single  COMPOOL  START-TERM  text  followed  by  one  or  more  START- 
TERM  texts  of  executable  (COMPUTE)  source. 

3.  One  or  more  COMPOOL  START-TERM  texts. 

The  default  action  is  to  process  type  1.  The  text  presented  under  the 
COMPUTE  option  is  assumed  to  be  a sequence  of  START-TERM  texts  which  are  exe- 
cutable. Any  particular  START-TERM  text  may  normally  require  a COMPOOL  for 
proper  compilation;  BASIC  will  properly  process  the  text  in  the  absence  of  its 
COMPOOL  under  the  COMPUTE  option  provided  a JAVSTEXT  directive  (Sec.  1.4) 
which  includes  the  related-text-name  parameter  appears  at  the  beginning  of  the 
START-TERM  text. 

Type  2 text  sequences  (one  COMPOOL  followed  by  one  or  more  executable  I 

texts)  are  processed  with  the  command : 

BASIC, TEXT  = BOTH. 

* 

With  this  option,  when  LIBOLD  is  used,  the  COMPOOL  must  be  included  on  READER, 
even  if  no  change  has  been  made  to  its  source. 

Type  3 text  sequences  (one  or  more  COMPOOL  texts)  are  processed  with  the 
command : 


BASIC, TEXT  = PRESET. 

BASIC  will  not  separate  source  text  into  modules  if  the  following  com- 
mand is  used: 

BASIC, TEXT  = JAVSTEXT. 

Since  the  unit  of  processing  for  most  other  JAVS  processing  steps  is  an  execu- 
table module,  this  command  prohibits  performing  module  analyses  on  the  text. 
(See  BASIC, DEFINES  = command  description  for  usage.)  All  errors  normally 
detected  by  BASIC  are  ignored  with  this  option. 


* 

See  Table 


1.1  on  page  1-4. 
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BUILD  LIBRARY. 


BUILD  LIBRARY. 


* 


Description 

This  macro  command  has  two  forms: 
BUILD  LIBRARY.  or 

BUILD  LIBRARY  = <name>. 


In  the  first  command  form,  the  library  name  given  to  LIBNEW  is  TEST.  In  the 
second  form,  the  user  specifies  the  library  name.  Both  command  forms  generate 
the  following  JAVS  standard  commands: 

CREATE  LIBRARY  = <name> . (or  TEST) 

START. 

BASIC, COMMANDS  = OFF. 

BASIC. 

FOR  LIBRARY. 

STRUCTURAL. 

END  FOR. 

The  macro  command  processor  generates  the  JAVS  "END"  command  if  it  is  not 
present  as  the  last  command. 

Rules 


(1)  See  BASIC  and  STRUCTURAL  constraints  in  Sec.  3.2  and  3.3. 

(2)  The  library  name  should  be  8 or  less  characters. 

(3)  This  macro  command  should  not  be  used  if  the  source  program  includes 
a COMPOOL  (constraint  2 on  page  3-3). 


Example  Command  Sets 

(1)  BUILD  LIBRARY  = REFMAN. 

DOCUMENT. 

This  command  set  will  create  a new  library,  perform  syntax  and  structural 
analyses  and  produce  a series  of  JAVS  reports  for  all  modules  in  the  JOVIAL 
source  program.  These  reports  are  useful  for  documentation,  maintenance, 
testing  and  retesting  the  source  program. 

(2)  BUILD  LIBRARY. 

PROBE, JAVS TEXT  = EXPROGM. 

PRINT, JAVS TEXT  = EXPROGM, INSTRUMENTED  = ALL. 


Can  be  used  only  with  the  overlay  version  of  JAVS. 
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CREATE  LIBRARY  = <libname> . 


CREATE  LIBRARY  = <libname> . 


Description 

This  library  command  specifies  that  LIBNEW  (a  "new  library")  will  be 
created  during  the  current  run,  as  is  normally  the  case  in  BASIC.  When  this 
option  is  specified,  LIBNEW  is  assumed  to  be  empty  at  the  beginning  of  a run. 
LIBNEW  is  a read/write  library. 

Rule 


The  library  name  should  be  8 or  less  characters. 

Example  Command  Set 

CREATE  LIBRARY  = REFMAN . 

START. 

BASIC. 

END. 
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DEPENDENCE , 3ANDS . 


DEPENDENCE , BANDS ■ 


Description 


This  command  has  two  f oms: 

DEPENDENCE .BANDS,  or 

DEPENDENCE , BANDS  * <number>.  (DEFAULT  =2.) 

The  outcome  of  this  cotanand  is  a "snapshot”  of  the  position  of  the 
selected  nodule  within  the  inter-nodule  hierarchy.  The  sample  output  shews 
the  3ANDS  report  for  the  default  width.  To  the  left  of  the  selected  nodule 
is  shown  the  structure  of  the  calls  to  the  nodule;  to  the  right  of  the 
selected  nodule  is  shown  the  invocation  structure  emanating  from  the  nodule. 
The  number  of  bands  is  the  width  (in  each  direction)  of  the  structure  dis- 
played. Up  to  five  bands  nay  be  displayed  on  this  report.  This  report  is 
useful  in  determining  the  extent  of  inter-module  dependence  to  several  levels. 
Modules  which  are  called  from  only  one  other  module  are  potential  candidates 
to  head  a link  for  overlay  purposes. 

The  nodules  listed  under  column  -1  call  the  selected  nodule  directly 
(i.e.,  GTCR  and  OLOOK) . The  modules  listed  under  column  -2  call  those  in 
column  -1.  For  example,  GTCR  is  called  by  CK3K,  LUK,  and  OLOOK. 

The  nodules  listed  under  column  1 are  called  by  the  selected  module 
(e.g.,  3T0H,  ERRXR,  GTCARD,  etc.).  The  modules  listed  under  column  2 are 
called  by  those  listed  under  column  1.  For  example,  ERRXR  calls  3T0D,  ERROR, 
OPUT,  and  SYSTEMP. 

Rule 

Maximum  bandwidth  is  5. 

Sample  Output 


KOOULE 

INVOCATION  BANOS 

■OOULE 

< NPU  T >»  jAVSTElT 

<NPuT  >*  PAPENT  «OOULE  <NPuT 

> 

LEVEL 

•i  o 

1 

2 

NPuT 

GTCR 

CKBK 

LUK 

OLOOK 

OLOOK 

LOOK 

ATOM 

C«Px« 

8 T 00 
f DOOQ 
OPUT 
$v$Trup 

STC190 

HOLS 

I*«08 

PQX  X 

BTOO 

COOxff 

FATAL 

OPUT 

VOtPtjP 
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DEPENDENCE, BANDS.  (Cont.) 


Example  Command  Set 

OLD  LIBRARY  = REFMAN. 
START. 

DEPENDENCE .GROUP .LIBRARY . 
FOR  LIBRARY. 

DEPENDENCE, BANDS  = 5. 

END  FOR. 

END. 
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/ • . 

* * 


DEPENDENCE  . CROUP  , ALTL 1 3 . 


DEPENDENCE, CROUP, AUXLIB 


Descript  ion 


The  outcome  of  this  library  command  is  a report  which  identifies  all 
modules  not  present  in  the  library  which  are  called  by  modules  in  the  library. 

The  data  presented  is  useful  in  analyz- 
the  library  to  other  software.  Each  X 
mark  represents  an  invocation  by  the  module  in  the  list  dcvji  the  page  to  the 
module  in  the  list  across  the  page.  The  modules  are  presented  in  alphabetical 
order . 


The  sample  output  shows  this  report, 
ing  interfaces  of  all  the  modules  on 


Pule 

Maximum  of  100  library  modules  for  this  report. 
Sample  Output 


AUXILIARY  LHBASy  0EBENOE‘*CE  TA8LE 


.1 
I .» 

N.V 

v.o 

0.K 

K.E 

E. 

a 

• • 

♦ At)£f  GGC,H  ! I WUUUOPP008SSK  • 

• C TPAETVONNOODL'PP'JUE  to  YS  ♦ 

•SOBTTCEl«Sa«SVU«TT«SSSA» 
» ThO  ASAuSCt'N'iS?  T * 9L0  S*p» 
♦ S PLLSP  S AET  LSU  TEU» 

E * KD  8X  KTO  S«P* 

.♦  P ♦ 

ADC« 

» 

ADO  TOK 

♦ X 

XX  ♦ 

8T00 

♦ 

CIDNT 

♦ 

X ♦ 

CKRK 

♦ 

CONTOK 

♦ X 

X ♦ 

0T09 

♦ 

EEAC 

♦ 

EQPXQ 

♦ X 

X X . 

GETS 

♦ 

X ♦ 

GETC 

♦ 

X ♦ 

GTC9 

♦ 

LOOK 

♦ X 

X ♦ 

LUK 

♦ 

X ♦ 

MUVl 

* 

MUV* 

♦ 

NPUT 

♦ X X XX 

X ♦ 

OLOOK 

♦ 

0UTS8 

♦ X X 

X XX  XX  X ♦ 

PPM 

♦ 

PVAIU 

♦ X 

X ♦ 

SflPTP 

♦ 

SGNP 

♦ 

TEPMIN 

♦ X 

X X ♦ 
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DEPENDENCE, GROUP. AUXLIB.  (Cont.) 


Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN. 
START. 

DEPENDENCE , GROUP .LIBRARY . 
DEPENDENCE, GROUP, AUXLIB. 
END. 

(2)  OLD  LIBRARY  = REFMAN. 
START. 

DEPENDENCE , GROUP .LIBRARY . 
DEPENDENCE , GROUP , AUXLIB . 
FOR  LIBRARY. 

DEPENDENCE .PRINT , INVOKES . 
END  FOR. 


DEPENDENCE , GROUP , LI3RARY 


DEPENDENCE  , GROUP  .LIBRARY  . 

Description 

The  outcome  of  this  library  command  is  a report  vhich  identifies  the 
interdependencies  of  all  known  nodules.  The  sample  output  shows  a sample  of 
this  report.  Only  modules  present  in  the  library  are  listed.  Each  X mark 
represents  an  invocation  by  the  module  in  the  list  down  the  page  to  the 
module  in  the  list  across  the  page.  The  modules  are  presented  in  alphabetical 
order . 

Rule 


Maximum  of  100  library  modules  for  this  report. 


Sample  Output 


L I 004  Sr  DEPENDENCE  T 4®LE 


.1 

I.X 

N.V 

V.O 

O.K 

K.E 

E.E 

o. 

♦ ♦ 

♦ AARCCC?€E'?GriLL'4MN0CP°SST* 
*00T  ;KOT*»£CTO»JULPt.U*VRGE  ♦ 
♦COOl A B T TCCK v VU0T« ABNB * 

♦rtonktbcxbc-*  i <»  r os 

♦ 0 T 0 B XB  Ijfl  I* 

♦ K K N ♦ 

» ♦ 

4DCO 

* • 

X 

XX  ♦ 

4 DO  TO* 

* • 

X X 

XX  ♦ 

0 TOO 

* • 

CIDNT 

CKPK 

• 

. * 

CON  tok 

♦ 

• 

OTOH 

♦ 

• 

EF4C 

♦ X 

• 

XX  ♦ 

EPBXP 

♦ X 

• 

GETS 

♦ 

• 

GETC 

♦ 

• 

GTC0 

♦ 

X • 

X X ♦ 

LOO* 

♦ X 

X 

xxx  ♦ 

LUK 

♦ X 

X XX 

• X X ♦ 

MUV1 

♦ 

X 

• * 

MUV4 

♦ 

X 

I.  » 

NPUT 

♦ 

X 

• x ♦ 

OLOOK 

♦ x xxx  xxxx  X 

xxxx.  X XX* 

OUTSB 

• * 

PRM 

. * • 

PV4LU 

X 

• * 

S0PTP 

X 

• * 

5GNP 

X 

XX  . ♦ 

TEPF'IN 

♦ X 

X 

• * 
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DEPENDENCE .GROUP .LIBRARY . (Cont.) 


Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN . 
START. 

DEPENDENCE .GROUP .LIBRARY . 
DEPENDENCE .GROUP .AUXLIB . 
END. 

(2)  OLD  LIBRARY  ■=  REFMAN. 
START . 

DEPENDENCE , GROUP .LIBRARY . 
DEPENDENCE , GROUP .AUXLIB . 
FOR  LIBRARY. 

DEPENDENCE, PRINT .INVOKES . 
END  FOR. 

END. 
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DEPENDENCE,  GROUP,  MODULES  = <name>  . 


DEPENDENCE, GROUP, MODULES  = <name>. 


description 


DEPENDENCE , GROUP , MODULES  = <name-l> , <name-2> , . . . ,<name-n> . 

This  library  command  allows  the  user  to  identify  a group  of  nodules  for 
which  inter-group  and  intra-group  computations  are  performed  on  the  library. 
The  modules  so  grouped  are  related  in  some  way  known  by  the  user.  For  exam- 
ple, the  group  may  be  a subset  of  all  the  modules  in  the  library  which  imple- 
ment a particular  functional  process.  The  list  of  modules  named  in  this  com- 
mand is  called  the  selected  group. 

The  outcome  of  this  library  command  is  a report  which  identifies  all 
interdependencies  between  the  selected  group  and  the  remainder  of  the  library. 
The  sample  output  shows  a sample  of  the  report  generated  by  this  command. 

Each  X mark  in  the  matrix  represents  an  invocation  by  the  module  in  the  list 
down  the  page  to  the  module  in  the  list  across  the  page.  In  the  upper  left 
quadrant  of  the  matrix  are  all  intra-group  dependencies.  In  the  upper  right 
quadrant  are  all  other  modules  called  by  members  of  the  group  (whether  on  the 
library  or  not).  In  the  lower  left  quadrant  are  all  other  modules  in  the 
library  which  call  one  or  more  members  of  the  group.  In  the  lower  right 
quadrant  are  the  direct  invocations  of  other  library  modules  to  all  other 
modules  called  by  the  group.  The  modules  are  presented  in  alphabetical  order. 

Rule 


Maximum  of  115  modules  in  the  invokee  groups. 
Sample  Output 


GROUP  DEPE^CE '■Cr  TABLE 


.1 

♦ 

♦ 

I • N 

♦ AC  GG 

OOPS ♦ A A8CC 

OE£GGMlLMMMMNppopp^T 

N.V 

♦OOEELIiPR*COTIKTPSPTOMUUOUUPUUVE1'OGF. 

v.o 

• ONTT'OTMP«SCOC’BO<sRTCLS'<40VVuTTi'.<SPki9 

O.K 

» T TRCOS  T*TPONKSCT«PS0 

NSl* 

TetLi  bb" 

K.E 

♦ 00 

KB  Q^0  T 

BL 

ET 

lsuu  r t 

E.E 

♦ KK 

♦ 

K 

X 

nr  o a v 

R. 

♦ 

AUOTOK 

♦ .* 

XX  ♦ 

X X 

XX 

C0NT0* 

♦ • 

♦ 

X 

X 

GET0 

* • 

♦ 

X 

GETC 

♦ • 

♦ 

X 

OLOOK 

♦ X 

• ♦ xxxxxxx  X 

« * * * * tx 

0UTS8 

• * X 

x X 

XX 

XX  X 

PPM 

.*♦ 

S9PTP 

• ♦ 

X 

LOOK 

♦ X 

x v x ♦ 

X X 

UJK 

♦ X 

♦ X 

X X 

X 

X 

MUV* 

♦ X 

♦ 

X 
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DEPENDENCE, GROUP, MODULES  = <name>. 


Example  Command  Set 

OLD  LIBRARY  = BIGLIB. 

START. 

DEPENDENCE , GROUP , MODULES  = ADDTOK , PRM , OUTSB , CONTOK , GETB , GETC , 
SBPTR. 

END. 


DEPENDENCE, PRINT, INVOKES. 


DEPENDENCE .PRINT , INVOKES . 


Descrioti.cn 


The  outcome  of  this  tJodule  command 
cations  of  the  selected  nodule  from  all  o 
cations  within  the  selected  module  to  all 
shows  a report  produced  by  this  command, 
ber  of  the  invocation  and  the  source  text 


is  a report  which  shows  (1)  the  invo 
ther  known  modules  and  (2)  the  invo- 
other  modules.  The  sample  output 
For  each  module  the  statement  num- 
for  the  invocation  are  shown. 


Samole  Cutout 


•oouit  ;i*oc*ncN  s»»cc... 

•C0U1.C  «N#uT  >.  J4VSTHT  <R»'JT  >,  MODULI  <**»UT  » 


3 

P*OC  nput  s 

< 1) 

INVOCATIONS  'BOM  wIThIn  This  MODULE 

*COuiE  "TOH 

STMT  • 

69 

arOH  ( 

LTNCNT  ) 

STMT  • 

69 

9 T Oh  t 

STCTM  ) 

MODULE 

STMT  • 

29 

raaio  ( 

A 1 

MODULE  0TC»«0 

STMT  • 

M 

3TCAP0 

( • STATUS  . CB01  J 

*OOUlE  *OlS 

STMT  • 

IS 

MOLS  < 

MOEF  (SAD  ) 

*OOUlE  INMOB 

STMT  • 

♦ 6 

InhOM  ( 

9 ) 

MODULE 

STMT  ■ 

79 

PQXM  ( 

*€L  » 129  t EjCT  ) 

MODULE  tcsnIM 

STMT  • 

♦ 9 

TEPMIn 

( 1 ) 

INVOCATIONS  to 

This  module 

F90M  WITHIN 

rfOOULC  OTC0 

stmt  • 

31 

N»ur 

mOOULE  QLOOK 

STMT  • 

119 

n»ut 

STMT  ■ 

306 

NPuT 

STMT  • 

363 

NPUT 
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'milt  ii’iii'riihi'^* 


DEPENDENCE .PRINT , INVOKES . (Cont.) 


Example  Command  Sets 

(1)  OLD  LIBRARY  = BIGLIB. 
START. 

JAVSTEXT  = NPUT . 

MODULE  = NPUT. 

DEPENDENCE .PRINT , INVOKES 
END. 

(2)  OLD  LIBRARY  = BIGLIB. 
START. 

DEPENDENCE , GROUP .LIBRARY 
FOR  LIBRARY. 

DEPENDENCE , PRINT , INVOKES 
END  FOR. 


Description 

This  library  command  results  in  an  analysis  of  the  interdependencies 
of  all  known  nodules  for  interfaces  to  other  software.  The  sample  output 
shows  the  report  produced  by  this  command. 

Sample  Output 

LIBRARY  OE°ENLENCE  summary... 

the  following  procedures  are  mot  invoked  by  any  module  on  t»e  library 
LOOK 

THE  FOLLOWIN'*  PROCEDURES  00  MOT  INVOKE  ANY  MODULE  ON  THE  LIBRARY 
I • PROCEDURES  DO  NOT  INVOKE  ANT  MQOULES  AT  ALL  I 

CONTOK 

OUTSH 

3ETR 

GETC 

9 TOO  • 

CIDNT 

0 TOR  • 


Example  Command  Set 


OLD  LI3RARY  = REFMAN. 
START . 

DEPENDENCE , SUMMARY . 

FOR  LI3RARY. 

DEPENDENCE .PRINT , INVOKES . 
END  FOR. 

END. 


Description 


This  module  command  displays  the  hierarchical  structure  of  all  modules 
invoked  from  the  named  module.  The  sample  output  shows  a report  from  this 
command.  The  level  in  the  hierarchy  is  shown  in  the  first  column.  The  next 
column  shows  all  modules  on  the  first  level.  Each  succeeding  column  indicates 
the  relative  position  of  the  named  module  in  the  hierarchy.  Those  modules 
with  an  asterisk  shown  to  the  right  are  not  on  the  library.  Structures  which 
are  repeated  are  indicated  by  (ETC.).  The  modules  are  alphabetical  within 
each  level. 


Sample  Output  (Excerpt) 


DEPENDENCE  TREE (»NOT  IN  LIBRARY) 

NOOULE  <NPUT  >,  JAVSTEXT  <NPUT  >.  PARENT  MODULE  <NPuT 

1 BTOH  • 

1 ERRXR 

? RTOD 

2 ERROR  • 

2 OPUT  • 

2 STSTEMP  • 

1 GTCARD  • 

1 HOLS  • 

1 INMDB  • 

I PPxi  • 

1 TERMIN 

? ptoo 

ERR**-' 

? (ETC.) 

2 fatal  • 

2 OPUT  • 

2 MRAPiJP  • 


Example  Command  Set 


OLD  LIBRARY  = REFMAN. 
START . 

FOR  LIBRARY. 
DEPENDENCE, TREE. 

END  FOR. 

END. 
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DESCRI3E  = <ootion>. 


-ESCRIBE  = <cp c 1 or. > . 


Tescriotion 


This  library  option  command  has  the  fora: 

UESCRI3E  = ON /OFF.  (DEFAULT  = OFF.) 

This  option  turns  ON  or  OFF  a sequence  of  printouts  which  describe  the  library 
manager  information.  The  default  is  OFF. 

E.-iar.nla  Ccrmar.d  Set 

ALTER  LI3RARY  = REFMAN. 

DESCRI3E  = ON. 

START. 

FOR  LI3RARY . 

STRUCTURAL. 

END  FOR. 

ENT). 
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DOCUMENT. 


DOCUMENT . 


* 


* 


Description 

This  macro  command  has  three  forms: 

(1)  DOCUMENT. 

(2)  DOCUMENT, JAVSTEXT  = <text-name>. 

(3)  DOCUMENT, JAVSTEXT  = <text-name>, 

MODULE  = <name-l> ,<name-2> , . . . <name-n> . 

Each  form  of  the  DOCUMENT  macro  command  generates  a series  of  JAVS  standard 
commands  which  produce  reports  useful  for  program  documentation,  maintenance, 
and  testing. 

The  expansion  of  each  form  of  the  DOCUMENT  macro  command  is  as  follows 

(1)  ASSIST , CROSS REF, LIBRARY . 

DEPENDENCE , GROUP , LI BRARY . 

DEPENDENCE , GROUP , AUXLIB . 

DEPENDENCE .SUMMARY . 

FOR  LIBRARY. 

PRINT, MODULE. 

DEPENDENCE, BANDS  = 5. 

DEPENDENCE, PRINT, INVOKES . 

END  FOR. 

This  form  (DOCUMENT.)  is  for  documenting  the  entire  library. 

(2)  ASSIST, CROSSREF, LIBRARY. 

DEPENDENCE , GROLT  , LIBRARY . 

DEPENDENCE .GROUP .AUXLIB . 

DEPENDENCE .SUMMARY . 

JAVSTEXT  = <text-name>. 

FOR  JAVSTEXT. 

PRINT, MODULE. 

DEPENDENCE, BANDS  = 5. 

DEPENDENCE , PRINT , INVOKES . 

END  FOR. 

This  form  (DOCUMENT , JAVSTEXT  = < text-narae> . ) is  for  documenting  module 
interdependencies  for  the  entire  library,  producing  a library-wide  cross 
reference  of  symbols,  and  generating  module  documentary  reports  for  the  speci 
fied  JAVSTEXT. 


it 

Can  be  used  only  with  the  overlay  version  of  JAVS. 


• ' JL 

„ A 


. - k 
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DOCUMENT.  (Cent.) 


(3)  ASSIST, CROSSREF.LI3RARY. 

DEPENDENCE , GROUP .LIBRARY . 

DEP  ZNDENCE , GROUP , AUXLI3 . 

DEP  ENDENCZ , S UMMARY . 

JAVSTEXT  * <text-name>. 

FOR  MODULE  = <name-l> , <name-2> , . . . ,<name-n> . 

PRINT, MODULE. 

DEPENDENCE , 3 AMDS  = 5. 

END  FOR. 

This  fora  (DOCUMENT,  JAVSTEXT  = < te:<t-nane>  , MODULE  = ....) 
produces  Che  sane  reporc  as  in  (3),  excepC  that  Che  nodule  reporcs  are  genera- 
Ced  only  for  che  specified  nodules  in  the  JAVSTEXT. 

No  te 

The  macro  co errand  processor  will  generace  che  commands: 

OLD  LIBRARY  = TEST. 

START. 

if  che  firsc  JAVS  command  is  a macro  command  (keywords  BUILD  LI3RARY, 

DOCUMENT, PROBE, TEST) . The  macro  command  processor  will  generace  Che  "END" 
command,  if  it  is  not  present. 

Rules 

(1)  A maximum  of  100  JAVSTEXTs  can  be  used  in  a cross  reference  mapping. 

(2)  A maximum  of  100  modules  can  be  used  in  the  GROUP  reports. 

(3)  A maximum  of  23  modules  can  be  specified  in  the  second  form  of  the 

DOCUMENT  macro. 

(4)  The  DOCUMENT  macro  command  requires  that  syntax  and  structural 
analyses  have  already  been  performed  on  the  entire  library. 


Example  Command  Sets 

(1)  BUILD  LIBRARY. 

DOCUMENT. 

This  command  set  will  create  a new  library  called  TEST  and  produce  JAVS 
documentation  reports  for  all  modules  on  the  library. 

(2)  OLD  LI3RARY  = REFMAN. 

START. 

DOCUMENT, JAVSTEXT  = EXPROGM, MODULE  = EXMPL1,EXMPL2,EXMPL3. 

FOR  MODULE  =»  EXMPL1 , EXMPL2  , EXMPL3 . 

PRINT, DDPATHS. 

END  FOR. 
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DOCUMENT.  (Coat.) 


This  command  set  uses  an  existing  library  called  REFMAN  to  generate  the 
libraryvide  module  interdependency  and  cross  reference  reports  and  the  module 
documentary  reports  for  EXMPL1,  EXMPL2,  and  EXMPL3. 
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END. 


END. 


Descriotion 


After  the  operations  indicated  by  the  contents  of  the  command  file  are 
complete,  JAVS  must  be  "shut  down"  by  use  of  the  following  command: 

END. 

The  END.  command  must  always  be  the  last  JAVS  command.  The  actions  which 
occur  as  a consequence  of  this  command  are  important  to  the  JAVS  user  in  only 
one  regard — when  LI3NEV  is  completed  and  is  to  be  saved  for  future  runs.  The 
wrapup  sequence  provides  necessary  information  about  the  contents  of  the  new 
library.  The  sample  output  shows  the  standard  wrapup  output,  after  running 
3ASIC  and  STRUCTURAL.  This  report  contains  a printout  of  the  Module  Descrip- 
tor Table  and  library  information  for  LIBOLD(l)  and  LI3NEW(2). 

Rule 

This  must  be  the  last  JAVS  command. 

Sample  Output 


Jk*%  •®4*U*... 


-CO'JLC  DC**... 


90. 

"0CUI.C 

tflT 

NKt 

Trot 

SCC!»f 

*OC9t 

l:ns  s 

'*7S 

C»CC 

ST-’S 

r r»3T 

?xCC 

• 0*0 
*4  .-as 

T04S 

s**»s 

SL7S 

3«rs 

,1099 

DS 

91.95 

*4»«5 

19  OUT 

310CCT 

CD^C 

CQ-* 

TOT  DO* 

1 

CiCOMOi. 

c iCTw^L 

:*oL 

3 

13 

3 

3 

132 

SI 

3 

6 

3 

3 

ft 

ft 

0 

nO 

3 

ft 

* 

r |PC3G« 

£ rsjr3« 

f l»s 

1 1 r 

J 

33 

1* 

1 4 

2’3 

: »2 

2 

26 

2 

5 

23 

ft 

3 

NO 

0 

ft 

1 

C i 

t t&3C‘N 

?ips:j4 

5V.9V. 

ft 

6 

S 

4 

24 

l 

4 

3 

I 

5 

ft 

0 

NO 

ft 

9 

• 

C « -*»C  X 

* IPO,;;.* 

£ ( 3 a z J »> 

•»aoc 

:sr 

3 

• 4 

29 

4 

274 

2 3? 

3 

21 

1 

29 

14 

2 

3 

NO 

ft 

9 

% 

C*-»l3 

£ i«9', ; 

:lsp 

LOCI 

3 

4 

4 

4 

21 

14 

1 

3 

3 

t 

4 

ft 

ft 

NO 

ft 

ft 

IliBiar  j».r39,«4T:3N.-'aux  Of  j?3i 

V.!9«4»T  T*PC  34'C  1.45T  *C*4».  V.,,aan»,» 

*0.  **4*»c  4CCC53  i*.'C3€3  • Eft'S  n02uv.CS  *»4  3**Cn7S 


? Tfsr  9/»  3 r 3 1 2 3T31  l?*2ft  S 35 


Output  Description 

The  Module  Descriptor  31ock  (MDB)  summary  shown  in  the  sample  output, 
reading  left  to  right,  gives  the  following  statistics: 

1.  Module  number  on  the  file 

2 . Module  name 

3.  START-TERM  text  name 


Name  of  parent  module  (i.e.,  the  nodule  in  which  this  module  is 
contained) 
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END.  (Cont.) 


5.  Type  of  module  where 

CMPL  is  a COMPOOL 

PROG  is  a Program 

PROC  is  a Procedure 

CLSM  is  a CLOSE  of  global  scope 

CLSP  is  a CLOSE  of  local  scope 

TEXT  is  a START-TERN  text  which  has  not  been  separated  into 
modules  by  BASIC 

6.  Scope  of  an  executable  module  where 

EXT  is  a program  or  an  external  procedure 

INT  is  an  internal  procedure  (i.e.,  within  a program  or 
external  procedure) 

GLBL  is  a CLOSE  within  a program  or  external  procedure 
LOCL  is  a CLOSE  within  an  internal  procedure 

7.  Number  of  lines  of  probed  text  inserted  in  the  module  by  INSTRUMENT 

8.  Number  of  statements  in  the  module 

9.  Number  of  executable  statements 

10.  The  statement  number  of  the  first  executable  statement 

11.  Word  pairs  which  measure  the  amount  of  library  space  occupied  by 
the  source  text 

12.  Number  of  tokens  in  the  module 

13.  Number  of  symbols  defined  in  module 

14.  Number  of  symbols  referenced  in  module 

The  remainder  of  the  statistics  are  more  applicable  to  users  who  wish  to 
follow  a testing  strategy  of  analyzing  the  complexity  of  their  codes  and 
applying  testcases  to  more  comprehensively  exercise  those  modules  which  exhi- 
bit a greater  tendency  to  be  error  prone.  These  statistics  are  listed  below: 
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END.  (Cone.) 


15. 

Number  of 

16. 

Number  of 

17. 

Number  of 

18. 

Number  of 

19. 

Number  of 
function) 

o 

C 1 

YES  if  DI 

21. 

Statement 

statement 

22% 

DD-path  b 
DD-paths 

structure 


ocher  nodules  invoked  by  nodule 


DD-paths 

DD-path/ statement  block  entries 

formal  input  parameters  (-1  until  STRUCTURAL) 

formal  output  parameters  (-1  if  the  module  is  a 


RECT  code  is  present  in  module;  NO  otherwise 

-based  complexity  is  a summation  of  the  complexity 
s in  the  module* 


ased  complexity  is  a summation  of  the  complexity  of 
in  the  module.  This  is  used  as  an  indicator  of  the 
1 complexity  of  the  module.* 


o 


f all 


all 


These  statistics  can  be  used  by  the  tester  to  develop  a rational 
approach  to  program  verification  of  modules  which  have  the  greatest  tendency 
toward  error  (i.e.,  those  which  are  most  complex). 


The  Library  Information  report  shown  in  the  sample  output  includes  the 
name  for  each  library,  the  type  of  access,  the  date  created,  the  total  size 
and  other  useful  information. 


These  items  are  provided  for  future  extensions  to  JAVS  and  are  not  presently 
computed . 
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END  FOR. 


END  FOR. 


Description 

This  iteration  command  concludes  a block  of  commands  which  are  repeated 
for  each  specified  module.  There  are  three  sequences  of  commands  which  select 
a number  of  modules  and  iterates  a block  of  commands  (which  cannot  contain 
another  iteration).  The  three  forms  of  command  iteration  are: 

(1)  FOR  MODULE  = <name-l> <name-n> . 

(any  set  of  commands) 

END  FOR. 

(2)  FOR  JAVSTEXT. 

(any  set  of  commands) 

END  FOR. 

(3)  FOR  LIBRARY. 

(any  set  of  commands) 

END  FOR. 

Rule 

Maximum  of  150  modules  selected  in  command  iteration  loop. 

Example  Command  Set 

OLD  LIBRARY  = REFMAN. 

START. 

ASS  1ST, CROSSREF, LIBRARY. 

FOR  LIBRARY. 

PRINT, MODULE. 

ASSIST, PICTURE. 

END  FOR. 

END. 


; 

i 


i 
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FOR  JAVSTFXT. 


FOR  JAVSTEXT 


Descr lotion 


The  following  sequence  selects  each  known  nodule  within  the  "current 
text"  and  iterates  a block  of  connands  (which  cannot  contain  another  itera- 
tion) once  for  each  known  nodule  of  that  text: 

FOR  JAVSTEXT. 

(any  set  of  connands) 

EOT  FOR. 

Rule 


Maxinum  of  150  nodules  selected  in  this  iteration  cocnand , 

Exanole  Conr.and  Set 

OLD  LI3RARY  = REFMAN. 

START . 

JAVSTEXT  = EXP ROGM. 

FOR  JAVSTEXT. 

PRINT, MODULE. 

EOT  FOR. 

END. 
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FOR  LIBRARY. 


FOR  LIBRARY . 


Description 

The  following  sequence  selects  each  known  module  on  the  library  and 
iterates  a block  of  commands  (which  cannot  contain  another  iteration)  once 
for  each  module: 

FOR  LIBRARY. 

(any  set  of  commands) 

END  FOR. 


Rule 


Maximum  of  150  modules  selected  for  this  iteration  command. 
Example  Command  Set 

OLD  LIBRARY  = REFMAN. 

START. 

FOR  LIBRARY. 

DEPENDENCE .PRINT , INVOKES . 

PRINT, MODULE. 

END  FOR. 

DEPENDENCE .GROUP .LIBRARY . 

END. 
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1 


INSTRUMENT . 


L- 


INSTRUMENT . 


Description 

The  INSTRUMENT  command  with  all  options  at  their  default  values  produces 
the  small  report  in  the  sample  output.  The  actions  performed  by  the  INSTRU- 
MENT command  is  to  record  probe  text  statements  on  LIBNEV.'. 

Rules 

(1)  See  INSTRUMENT  constraints  in  Sec.  3.4. 

(2)  The  INSTRUMENT  options  are  reset  to  their  default  values  follow- 
ing execution  of  this  command. 

Sample  Output 


J0V1H  »UTO*tTCp  Vt<MMc»T10N  •••  INSTRUMENT 4T]0n  ••• 

options  ,N  trrtCT  . . . 

00-PATH  PROPE  ■ PROBE 

MODULE  PROBE  ■ PROB* 

TEST  PROBE  * PROBJ 

JNSTRUMf  N 7 I N G ENTRY  POINTS.  RETURNS  ANC  OD-PAThS  OF  KOOULE  <E*PROG*  > Of  JAVSTflT  X^ROG^*  > 


Example  Command  Sets 


(1)  ALTER  LIBRARY  = REEMAN . 

START. 

FOR  LIBRARY. 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  = EXPROGM, INSTRUMENTED  = ALL. 
END. 

(2)  OLD  LIBRARY  = REFMAN . 

START. 

JAVSTEXT  = EXPROGM. 

FOR  JAVSTEXT. 

INSTRUMENT , MODE  = FULL. 

INSTRUMENT. 

END  FOR. 

PUNCH, JAVSTEXT  = EXPROGM, INSTRUMENTED  = ALL. 
END. 
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< opr ion>  . 


INSTRUMENT .MODE  = 


INSTRUMENT,  MODE  = ^cntion>. 


description 


INSTRUMENT .MODE 


INVOCATION/DDPATHS /D IRECTIVES / FULL . 
(DEFAULT  = DDPATHS . ) 


This  command  allows  user  cor.traL  over  the  extent  of  probe  insertion. 
There  are  two  types  of  instrumentation:  structural  and  performance. 

Structural  instrumentation  may  be  requested  at  the  module  invocation 
and  return  level  with  the  command: 

INSTRUMENT, MODE  = INVOCATION. 

This  is  useful  in  developing  an  invocation  and  return  trace  for  a set  of 
modules . 

Structural  instrumentation  at  the  DD-?ath  level  is  produced  with  the 
default  option  of  the  command: 

INSTRUMENT, MODE  = DDPATHS. 

The  instrumentation  for  module  invocation  and  return  level  is  also  included. 
This  is  needed  to  develop  a complete  execution  trace  during  test  execution. 

JAVS  performance  instrumentation  is  produced  with  the  command: 

INSTRUMENT, MODE  = DIRECTIVES . 

This  is  used  when  execution-time  monitor  output  is  to  be  generated  as  the  re- 
sult of  user-supplied  JAVS  computation  directives  present  in  the  JOVIAL  source 
text  (see  Sec.  1.5) . 


Probe  text  for  both  structural  instrumentation  and  performance  instru- 
mentation is  produced  with  the  command: 


INSTRUMENT , MODE  = FULL . 

MODE  = FULL  is,  in  effect,  a combination  of  MODE  = DDPATHS  and  MODE  = 
DIRECTIVES. 

Example  Command  Sets 

(1)  ALTER  LI3RARY  = REFMAN. 

START. 

FOR  LI3RARY . 

INSTRUMENT , MODE  = INVOCATION. 

INSTRUMENT. 

END  FOR. 

END . 


INSTRUMENT  .MODE  = <option>.  (Cont.) 


(2)  OLD  LIBRARY  = REFMAN. 

START. 

JAVSTEXT  = EXPROGM. 

MODULE  = EXPROGM. 

INSTRUMENT, MODE  = INVOCATION. 

INSTRUMENT . 

FOR  MODULE  = EXMPL1 , EXMPL2 . 

INSTRUMENT, MODE  = FULL. 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  = EXPROGM, INSTRUMENTED  = EXPROGM, EXMPL1 .EXMPL2 . 
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INSTRUMENT  , PROBE  , DP  PATH  = <name> . 


INSTRUMENT,  PROBE,  DPP  ATH  = <r.ane>. 


Description 


INSTRUMENT, PROBE, DDPATH  = <probe-name> . (DEFAULT  = PROBE.) 

This  co expand  is  included  for  use  only  when  it  is  necessary  to  change  the 
name  of  the  DD-path  data  collection  routine  to  avoid  conflict.  If  the  de- 
fault name  PROBE  is  used  in  the  JOVIAL  source  being  processed,  a different 
name  must  be  selected  (and  appropriate  modif icatior.s  made  in  Test  Execution). 

Example  Command  Set 

ALTER  LIBRARY  = REFMAN. 

START. 

FOR  LI3RARY. 

INSTRUMENT, PROBE, DDPATH  = DDPATH. 

INSTRUMENT. 

END  FOR. 

END. 
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INSTRUMENT , PROBE , MODULE  = <name>. 


INSTRUMENT .PROBE .MODULE 


<name> . 


Description 

INSTRUMENT, PROBE, MODULE  « <invocation-name> . (DEFAULT  = PROBM.) 

This  command  is  included  for  use  only  when  it  is  necessary  to  change  the 
name  of  the  module  invocation-and-return  data  collection  routine  to  avoid  con- 
flict. If  the  default  name  PROBM  is  used  in  the  JOVIAL  source  being  pro- 
cessed, a different  name  must  be  selected  (and  appropriate  modifications  made 
in  Test  Execution). 

Example  Command  Set 

OLD  LIBRARY  = REFMAN. 

START . 

JAVSTEXT  = EXPROGM. 

FOR  JAVSTEXT. 

INSTRUMENT, MODE  = INVOCATION. 

INSTRUMENT, PROBE, MODULE  = INVOR. 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  = EXPROGM, INSTRUMENTED  = ALL. 

PRINT, JAVSTEXT  = EXPROGM, INSTRUMENTED  = ALL. 

END. 
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■ v*- r- 


INSTRUMENT,  PROBE.  TEST  = <name>. 


INSTRUMENT, PRC3E,  TEST  = <name>. 


Description 


INSTRUMENT, PROBE, TEST  = <test-nane>.  (DEFAULT  = PROBI.) 

This  command  is  included  for  use  only  when  it  is  necessary  to  change  the 
name  of  the  test-beginning  and  test-end  data  collection  routine  to  avoid  con- 
flict. If  the  default  name  PR03I  Is  used  in  the  JOVIAL  source  being  pro- 
cessed, a difrerent  name  must  be  selected  (and  appropriate  modifications  made 
in  Test  Execution) . 

Example  Command  Set 

OLD  LIBRARY  = REFMAN. 

START . 

JAVSTEXT  = EX? ROOM. 

FOR  MODULE  = EXFROGM , EXMPL1 . 

INSTRUMENT , STARTTEST  = EXMPL 1 , EXP  ROOM , 0 . 

INSTRUMENT, STCPTEST  = EXPROGM.EXPROCM.O . 

INSTRUMENT, PR03E, TEST  = TESTP3. 

INSTRUMENT, MODE  = FULL. 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  = EXPRCCM , INSTRUMENTED  = ALL. 

END. 


INSTRUMENT, STARTTEST  ■=  <options> . 


INSTRUMENT, STARTTEST  = <options>. 


Description 

In  order  to  identify  test  cases  and  control  the  recording  of  data  on  the 
AUDIT  file,  the  user  must  supply  invocations  to  the  data  collection  routine, 
PROBI.  The  invocations  can  be  manually  inserted  prior  to  Test  Execution,  or 
they  can  be  automatically  inserted  during  instrumentation  (see  Sec.  2.6.1). 

The  INSTRUMENT, STARTTEST  command  causes  JAVS  to  insert  an  invocation  to 
PROBI  for  identifying  a new  test  case.  The  command  is  of  the  form: 

INSTRUMENT , STARTTEST  = <m-name> ,<t-name> , <no . >{ ,<TESNAK> , <TFLAG> } . 


where 


m-name  = module  name 
t-name  = JAY ST EXT  name 
no.  * statement  number 

TESNAM  ■=  test  case  identifier  DEFAULT  = 8K(CASE  ) 

TFLAG  = test  file  control  value  DEFAULT  = 2 

The  command  options  must  be  given  in  the  order  shown  above.  The  user 
must  specify  the  module  and  JAYSTEXT  names  in  which  the  PROBI  invocation  is  to 
be  inserted.  The  user  must  also  specify  the  statement  number  (using  the 
statement  number  presented  in  a PRINT, MODULE  listing)  before  which  the  invo- 
cation is  to  be  inserted.  The  user  may  specify  the  statement  number  to  be  0. 
This  results  in  placing  the  PROBI  call  immediately  prior  to  the  first  software 
probe  (at  the  first  executable  statement). 

TESNAM  and  TFLAG  are  the  two  input  parameters  to  PROBI.  If  these  param- 
eters are  not  specified  in  this  command,  the  default  values  will  be  used, 
causing  tracing  of  module  invocations  and  returns.  TESNAM  may  be  up  to  8 
characters;  TFLAG  may  be  1,  2,  or  3.  A maximum  of  ten  INSTRUMENT, STARTTEST 
commands  can  be  used  for  a single  INSTRUMENT  verb.  The  module  and  JAYSTEXT 
names  may  be  different  in  each  command. 


Example  Command  Sets 

See  the  examples  for  the  INSTRUMENT,STOPTEST  command. 


A<ppt  icr.s> . 


INSTRUMENT , STOPTEST 


<ootions> . 


INSTRUMENT , STOPTEST 


Description 

This  command  is  used  co  automatically  insert  calls  co  data  collection 
routine  PRC3I  to  terminate  data  collection  on  the  AUDIT  file.  Its  utilization 
is  similar  to  the  INSTRUMENT , 5TARTTEST  command.  The  command's  form  is: 


INSTRUMENT , STOPTEST 


<m-name> , < t-r.ame>  ,<no . > . 


where 


m-name  = module  name 
t-r.ame  = Javstext  name 
no.  = statement  number 

Only  one  INSTRUMENT, STOPTEST  command  may  be  used  for  a single  INSTRUMENT 
verb.  The  PR03I  call  to  terminate  testing  will  be  placed  immediately  prior  to 
the  specified  statement  number  or,  if  the  statement  number  is  specified  as  0, 
immediately  following  the  software  probe  at  each  exit  from  the  module. 

Example  Command  Sets 

(1)  ALTER  LIBRARY  = REFMAN. 

JAVSTEXT  = EXPROGM. 

FOR  JAVSTEXT. 

INSTRUMENT, ST ARTTEST  = EXPROGM, EXPROGM, 16. 

INSTRUMENT , ST ARTIEST  = EXPROGM, ZXMPL 1,0. 

INSTRUMENT, STOPTEST  = EXPROGM, EXPROGM, 31 . 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  = EXPROGM, INSTRUMENTED  = ALL. 

END. 


This  command  set  will  instrument  DD-paths,  invocations  and  returns  for 
all  modules  .in  JAVSTEXT  EXPROGM.  In  addition,  the  calls  to  PR03I  to  initiate 
a new  test  oase  will  be  automatically  inserted  immediately  prior  to  statement 
16  in  module  EXPROGM  and  the  first  executable  statement  in  module  EXMPL1.  The 
test  termination  PROBt  invocation  will  be  automatically  inserted  prior  to 
statement  31  in  module  EXPROGM.  The  default  TESNAM  and  TFLAG  wili  be  used; 
thus  the  AUDIT  file  will  contain  only  a module  invocation  trace  but  coverage 
data  at  the  BD-path  level.  The  Instrumented  source  text  for  JAVSTEXT  EXPROGM 
will  be  written  to  file  LPUNCH,  as  well  as  stored  on  LI3NEW. 

(2)  OLD  LI3RARY  = REFMAN. 

START . 

JAVSTEXT  = EXPROGM. 

MODULE  = EXPROGM. 
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INSTRUMENT,  STOPTEST  »=  <options>.  (Cont . ) 


INSTRUMENT, MODE  = INVOCATIONS. 

INSTRUMENT, STARTTEST  = EXPROGM.EXPROCM ,0 .EXPROCM, 1 . 

INSTRUMENT, STOPTEST  = EXPROGM.EXPROGM.O. 

INSTRUMENT . 

FOR  MODULE  = EXMPL1 ,EXMPL2 , EXMPL3 . 

INSTRUMENT, STARTTEST  = EXMPL1 , EXPROGM , 9 , EXMPL1 , 3 . 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  ■=  EXPROGM, INSTRUMENTED  = ALL. 

END. 

This  command  set  will  instrument  module  EXPROGM  for  invocations  and 
returns  and  will  instrument  the  remaining  modules  in  the  JAVSTEXT  for  DD-paths 
as  well.  The  test  case  initiations  will  be  automatically  inserted  in  module 
EXPROGM  at  its  first  executable  statement  and  in  module  EXMPL1  at  statement  9. 
The  termination  of  all  test  cases  will  be  inserted  following  the  last  execu- 
table statement  in  EXPROGM. 

The  name  of  each  test  case  will  be  the  name  of  the  module  containing  the 
PROBI  call.  During  Test  Execution,  the  AUDIT  file  will  contain  no  trace  for 
module  EXPROGM,  but  it  will  have  a DD-path  and  module  invocation/return  trace 
for  the  remaining  modules  as  soon  as  PROBI  is  invoked  with  TFLAC-  = 3.  The 
AUDIT  file  will  contain  module  invocation/return  summary  data  for  all  modules 
in  the  JAVSTEXT  and  DD-path  summary  (coverage)  data  for  modules  EXMPL1, 

EXMPL2,  and  EXMPL3. 

The  instrumented  source  text  for  JAVSTEXT  EXPROGM  will  be  written  to 
file  LPUNCH . 
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JAVSTEXT  = <name> . 


JAVSTEXT  = <name> . 


Description 


Some  JAVS  commands  require  specification  of  the  START-TERM  text  sequence 
upon  which  computations  are  to  be  performed.  START-TERM  texts  are  known  to 
JAVS  by  their  names.  The  following  command  makes  the  "current  text”  be  the 
named  one: 


JAVSTEXT  = <text-name>. 

All  subsequent  commands  (if  they  refer  to  a specific  text)  are  applied  to  the 
specified  text.  There  can  be  any  number  of  JAVSTEXT  = commands.  A new 
JAVSTEXT  = command  replaces  and  supersedes  a previous  JAVSTEXT  = command. 

Example  Command  Sets 

(1)  .ALTER  LIBRARY  = REFMAN. 

JAVSTEXT  = EXPRCGM. 

FOR  JAVSTEXT. 

INSTRUMENT. 

END  FOR. 

END. 


(2)  ALTER  LI3RARY  = REFMAN. 
JAVSTEXT  = EXCOMP L . 
MODULE  = EXCOMPL . 

PRINT, MODULE. 

JAVSTEXT  = EXPROCM. 

FOR  JAVSTEXT. 
STRUCTURAL. 

PRINT, MODULE. 

ENT)  FOR. 

END. 


MERGE. 


MERGE. 


Description 

The  MERGE  command  can  be  used  (1)  to  add  new  modules  to  an  existing 
library,  and  (2)  to  replace  old  modules  with  new  modules  having  the  same 
module  name  and  same  text  name.  The  command  is 

MERGE. 

The  MERGE  command  merges  a LIBOLD  with  a LIBNEW.  After  merging,  LIBNEW 
contains  all  modules  on  the  original  LIBNEW,  plus  all  modules  on  the  LIBOLD 
that  do  not  have  the  same  module  name  and  same  text  name  as  a module  on  the 
LIBNEW.  Both  LIBOLD  and  LIBNEW  must  be  specified  in  the  library  commands  (see 
Sec.  4 and  4.1). 

Rule 


Maximum  of  250  modules  in  the  combined  library. 


Example  Command  Sets 

(1)  OLD  LIBRARY  = REFMAN . 

CREATE  LIBRARY  = NEWLIB . 
START. 

BASIC. 

MERGE. 

FOR  LIBRARY. 

PRINT .MODULE . 

END  FOR. 

END. 


This  command  set  will  create  a new  library  containing  the  syntax  analy- 
sis for  the  source  text  on  file  READER.*  After  the  library  is  built,  the  con- 
tents of  the  old  library  (LIBOLD) , excluding  any  modules  with  the  same  module 
and  text  names  as  those  on  LIBNEW,  will  be  copied  onto  the  new  library.  This 
command  set  can  be  used  for  replacing  a module  on  a library  with  a modified 
version  of  that  module.  In  this  case  LIBNEW  will  contain  the  same  module 
names  as  LIBOLD  contains,  but  LIBNEW  will  have  the  modified  module (s).  Fol- 
lowing the  library  merge,  the  above  command  set  will  print  all  of  the  modules 
on  LIBNEW. 

(2)  OLD  LIBRARY  = REFMAN. 

ALTER  LIBRARY  = OLIBE . 

START . 

MERGE. 

FOR  LIBRARY. 

STRUCTURAL . 

END  FOR. 

END. 

* 

See  Table  1.1  on  page  1-4. 
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MERGE.  (Cone.) 


This  ccmnand  set  assumes  that 
libraries  REFXAN  and  0LI3E.  All  of 
already  contained  in  0LI3E,  will  be 
will  be  performed  on  0LI3E.  REFMAN 

(3)  OLD  LI3RARY  = LI3E1. 

ALTER  LI3RARY  = LI3E2. 

START . 

MERGE. 

END. 


syntax  analysis  has  been  performed  on 
the  modules  in  REFMAH  (on  LI30LD) , not 
copied  to  LI3NEW.  Structural  analysis 
remains  unchanged. 


This  command  set  assumes  that  at  least  syntax  analysis  has  been  per- 
formed on  both  libraries.  LI30LD  will  be  copied  onto  LIBJJEW  (LIBE2) , exclud- 
ing any  modules  in  LI3E1  which  already  exist  in  LI3E2.  So  other  processing  is 
performed . 
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MODULE  = <name~- . 


MODULE  g <name> . 


Description 

Modules  are  known  to  JAVS  by  their  names  and  the  text  to  which  they  be- 
long. The  following  makes  the  "current  module"  within  the  "current  JAVSTEXT" 
be  the  named  one: 

MODULE  = <name>. 

All  subsequent  commands  (if  they  refer  to  a specific  module)  are  applied 
to  the  specified  module  within  the  "current  text."  If  no  current  JAVSTEXT  has 
been  specified,  the  module  selector  will  locate  the  module  using  only  its 
name . . 

*• 

Rule 


If  there  are  duplicate  module  names,  in  different  JAVSTEXT?,-  the  module 
selector  will  choose  the  last  one  on  the  librarv. 

»•  t 

Example  Command  Set 

OLD  LIBRARY  = REFMAN. 

START. 

JAVSTEXT  = EXPROGM. 

MODULE  = EXMPL1 . 

ASSIST, PICTURE. 

MODULE  = EXMPL2. 

PRINT, MODULE. 

END. 

This  command  set  will  produce  the  control  flow  picture  for  module  EXNFL1 
and  vTill  print  the  source  text  for  EXMPL2. 


This  cosnand  specifies  that  LI30LD  is  to  be  used  during  the  current  run 
The  name  identifying  the  library  should  be  that  same  as  when  the  library  was 
created.  LI30LD  is  a read-only  library. 


Rule 

If  che  name  is  different,  an  informative  message  is  printed,  but  pro' 
cessing  continues. 

Example  Command  Set 

OLD  LIBRARY  = REFMAN. 

START . 

DEPEND  EN  CE , GROUP , L 1 3RARY . 

FOR  LI3RARY . 

DEPENDENCE, PRINT , INVOKES . 

PRINT, MODULE. 

END  FOR. 


PRINT, DPP. 


PRINT, DPP. 

Pescription 

This  command  produces  a detailed  listing  of  the  JAVS  information 
describing  each  PP-path  within  the  current  module. 

The  properties  of  each  PP-path  shown  are: 

• The  PP-path  number 

• The  first  statement  on  the  PP-path 

• The  last  statement  on  the  DP-path 

• The  number  of  edges  (i.e.,  non-consecutive  statement  segments) 
which  comprise  the  PP-path 

* 

• The  complexity  of  the  PP-path 

* 

• The  highest  level  for  the  PP-path 

* 

• Parallelism  indicator 

* 

• The  number  of  times  the  PP-path  has  been  tested 

• The  number  of  statements  on  the  PP-path 

• PS  Table  index  of  the  first  entry  in  the  list  of  statements  on  the 
PP-path 

• The  list  of  statements  on  the  PP-path  in  execution  order. 


The  RAPC  version  of  JAVS  does  not  compute  a value  for  this  entry. 
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(Cone . ) 


PRINT, DPP 
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ExarxTe  Co™.and  Set 


OLD  LIBRARY  = REFMAN. 
START. 

FOR  LIBRARY. 

PRINT,  MODULE. 

PRINT,  DDP. 

PRINT,  DDPATHS. 

END  FOR. 

END . 


PRINT , DDPATHS ; 
Description 


PRINT, DDPATHS. 


u f 


For  the  current  module,  this  command  produces  a detailed  listing  of  the 
source  text  for  the  statements  which  begin  a DD-path  with  the  DD-path  descrip- 
tion included.  The  report  is  similar  in  format  to  the  report  from  the  PRINT, 
MODULE  command.  Only  those  statements  which  begin  a DD-path  or  are  crucial 
to  the  interpretation  of  a DD-path  (e.g.,  FOR,  SWITCH)  are  displayed. 

Sample  Output 

MOOULE  00-P4TM  OtflNlTION  listing 

MODULE  «E*m>>L1  >•  J*VSTE*T  <EXPBOGN  ».  P»»ENT  MODULE  <E«PBOG»  » 


MO. 

L vi 

statement 

DD-patms 

GENERATED 

1 

( 0> 

PROC  E*"PL1  C L I M I T 1 , LIMIT?  ) % 

•• 

OD-patm 

1 

IS 

PROCEDURE  ENTPt 

• • • • 

9 

1 1 ) 

IF  L I M I T 1 60  100  * 

• • 

DO-RaTm 

? 

IS 

TRUE  BRANCH 

•• 

00-RaTm 

3 

IS 

false  branch 

I? 

( 1 ) 

FOR  I • 1 • 1 • LIMIT]  $ 

13 

< 2) 

BEGIN 

• • • • 

1* 

( 2) 

FOB  J m 1 • 1 • LIMIT?  S 

19 

I 3) 

BEGIN 

2 1 

( 3) 

IFEITh* j LO  3 S 

• • 

DD-path 

A 

IS 

tpuf  branch 

• • 

DD-Path 

5 

IS 

FALSE  BRANCH 

2 3 

( 3) 

opif’i’s 

• « 

DD-path 

6 

IS 

TRUE  BRANC* 

• • • • 

25 

( 3) 

END 

• • • • 

27 

( 3) 

SWITCH  PICK  ■ ( L40EL1  . L4BEL1 

• LABEL  1 • LABEL?  ) 

s 

?« 

1 3) 

OOTO  PJC*  (S  INDXS  - 1 f)  % 

• • 

DD-patm 

T 

IS 

Switch  ouTway  j 

• • 

DH-PATm 

A 

IS 

SWITCH  OUTWAY  ? 

• • 

DD-path 

R 

IS 

Switch  ouTway  3 

• • 

DD-p a tm 

1 0 

IS 

SWITCH  OUT-AY  « 

•• 

DD-PATh 

11 

IS 

SWITCH  OUTWAY  5 

• • • • 

30 

( 3> 

LABEL  1 • 

IEEITm  RESULT  LS  4 S 

• • 

OO-PATh 

I? 

rs 

true  branch 

• • 

DD-paTh 

1 3 

IS 

false  branch 

3 2 

< 3) 

orif  RESULT  EO  4 s 

•• 

DD-path 

1 4 

IS 

TRUE  BRANCH 

• • 

OD-patm 

1 5 

IS 

false  branch 

34 

( 3) 

OR  IF  * 1 * t 

»• 

OO-PATh 

16 

IS 

TRUE  BRANCH 

36 

( 3) 

end 

• • • • 

39 

( 3) 

END 

•• 

DD-path 

IT 

IS 

LOOP  ON  FOR  AGAIN 

• • 

DD-path 

li 

IS 

ESCAPE  FOR  LOOP 

• • • • 

«t 

< it 

END 

• • 

DD-PATh 

19 

IS 

LOOP  ON  FOR  A&AJN 

• • 

OD-PaTh 

10 

IS 

ESCAPE  for  LOOP 
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. ... 


PRIM.  DMT. 


PRIM,  DMT, 


Description 

This  command  produces  a listing  of  the  internal  dependent  module  table 
(DMT)  descriptions.  The  table  contains  an  entry  for  each  invocation  con- 
tained in  the  current  module.  Pointers  to  other  internal  tables  (e.g.,  the 
SB  and  SLT)  are  included.  This  output  is  intended  for  JAVS  svstem  maintenance 
only. 

Sample  Output 


dependent  nodule  table  listing 

NODULE  «E*PR0G"  >.  J»VSTE*T  <E«P»OGN  >,  PARENT  NODULE  <E«PROG“  > 


e*U»NAL 

SLT 

STnt  or 

NQD-PR  Or 

SERIAL 

NO. 

invokeo 

N JNBER 

INVOCATION 

INVOCATION 

INVOCATION 

I 

CKN*»L  1 

?* 

1 

1 

? 

CUMPL? 

?6 

n 

3 

Example  Command  Set 

OLD  LIBRARY  = REFMAN. 
START. 

JAVSTEXT  = EXPROGM. 
MODULE  = EXPROGM. 
PRIM,  DMT . 

END. 
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■ A L'  ,,n. 


description 

This  command  produces  a listing  of  the  source  statements  in  the  named 
START-TERM  text  as  they  vere  originally  stored  on  the  library  (see  Sec.  1.4). 
The  sample  output  is  after  STRUCTURAL  processing.  The  salient  features  are: 

• The  statement  number  assigned  by  JAVS 

• The  level  of  nesting  of  the  statement 

• The  label(s)  and  text  of  the  statement  indented  to  show  nesting 
level  (e.g.,  FOR,  IF,  and  IFFITH  hierarchy) 

• The  numbers  of  the  DD-paths  which  are  identified  and  assigned  by 
JAVS 

• Statement  type  for  most  control  statements 
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ITEM  CARf1  M *0  4 

is 

( 

0 ) 

FILE  RfADfW  m 0 9 ft*  V(OK)  V(EOF)  7 APE  5 

1 4 

< 

0 > 

F J i_  E PCJsTR  h p 0 1 ?6  v«0ft)  V(EOF|  T APE  6 

15 

1 

0 ) 

MON  1 T OP  10  • 1 T E W 1 A . I TE  9?A  4 

If 

( 

0 > 

MESSAG  « MSG  1 4 

IT 

( 

01 

OUTPUT  PPJNTP  MESSAG  S 

ie 

( 

01 

PS. 

INOJT  RE»0E0  C»»t>  S 

19 

< 

Of 

IF  REAOfP  MS  V ( E OF ) 4 

?0 

( 

1 ) 

0EGI* 

?1 

l 

1 ) 

BtTE  IS  0 . 4 Si  1 ID  1 4 BYTE  IS  0 . 

29 

i 

1 ) 

8 y TC  (40.44*  < I Tf P 1 A > • 0 rTE  (4 

?3 

( 

1 ) 

BYTE  (4  C « 4 4)  1 I T E P ? A ) • BYTE  (4 

?4 

1 

1 ) 

1*mpL)  ( 1TER1  . 1TER2  ) 4 

1 

( 

1 1 

close  c»“ol?  s 

/ 

1 

1 » 

tt  main  close  t* 

3 

1 

2) 

BE  GIN 

4 

( 

2) 

1 T E R 1 • 1 4 

5 

< 

?> 

ITER?  . 1 S 

f 

C 

?» 

END 

?5 

1 

1 ) 

**  C*MPW?  tt 

?f 

< 

1 ) 

IF  1TE»1  GC  100  4 

?7 

1 

2) 

GOTO  E*mpl?  s 

?ft 

1 

1 > 

60TO  9G  4 

29 

( 

1 ) 

t nc 

so 

1 

0> 

If  IF  «« 

31 

1 

l 

0» 

STOP  4 

< 

C ) 

PRO:  C»MPL1  ( LIMIT)  , LIMIT?  ) 4 

2 

( 

1 J 

BEGIN 

3 

1 

1 ) 

ITEM  LIMIT)  I ?4  S % 

4 

( 

] ) 

ITEM  l I m I Y p I ?*  S 4 

5 

< 

1 1 

A»»AY  FILL  100  I ?4  S 4 

f 

( 

1 ) 

ITEM  RE  SUfc  Y I ?4  S 4 

7 

( 

1 f 

ITEM  1 NO  * S 1 ?4  S \ 

ft 

t 

1 » 

tf.  TRACE  « RESULT  •• 

9 

1 

1 ) 

IF  LIMIT)  GO  100  4 

1C 

1 

2) 

L 1 M ) T 1 « 99  4 

11 

( 

1 ) 

RESULT  • A f 

i *-  si  ir 


4 SI  I C»RD 


l *-  Si  U 

Imv 


i ?•  si  ir 


Example  Command  Set 


OLD  LIBRARY  = 
Si ART , 

PRINT, JAVSTEXT 
END. 


REFMAN . 


EXPROGN. 


This  command  has  two  forr.s: 


PRINT, JAVSTEXT  = <text-name> , INSTRUMENTED  = ALL.  or 

PRINT,  JAVSTEXT  = <text-nane> , INSTRUMENTED  = <nane-I>  , <"name-2>  , . . . , 
<name-n> . 

The  command  produces  a listing  of  the  instrumented  source  (i.e.,  results 
of  INSTRUMENT)*  in  the  named  START-TERM  text.  The  first  form  is  used  when  all 
modules  of  the  text  are  listed  with  instrumentation  inserted.  The  second  form 
is  used  when  specified  modules  in  the  text  are  to  have  instrumentation 
inserted  and  all  other  modules  in  the  text  are  not  instrumented.  Any  module 
which  has  not  been  processed  by  INSTRUMENT  will  be  shown  in  its  original  form. 
The  modules  must  be  listed  in  the  same  order  in  which  they  appear  on  the 
library.  The  salient  features  of  the  output  are: 

• The  statement  number  within  the  module  of  the  original  source 
statement  assigned  by  JAVS 

• The  level  of  nesting  of  the  statement  or  an  indicator  (P)  if  the 
statement  shown  is  a probe  (i.e.,  generated  by  INSTRUMENT) 

• The  label (s)  and  text  of  the  statement  indented  to  shew  nesting 
level. 

The  code  generated  by  the  instrumentation  does  not  affect  the  logic  of 
the  user's  program.  In  some  instances  (as  with  the  last  statement  11  in  the 
sample  output),  a ? is  placed  by  the  user's  own  code.  This  happens  when  the 
instrumentation  code  modification,  stored  in  the  library,  is  identical  to  the 
user's  statement. 

Rule 

Specified  modules  must  be  in  the  same  order  in  which  they  appear  on  the 
library. 


The  instrumented  text  consists  of  the  source  text  interspersed  with  the  probe 
text  generated  by  INSTRUMENT. 
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PRINT, JAVSTEXT 


<name> , INSTRUMENTED  = <optlon>,  (Cont.) 


Sample  Output 

J4VSTf.IT  <C«OHO(.-  > LISTING 


MO.  LVL  STATf^tMT  00*PATmS 


1 

( 

0 ) 

AA.  JAVSTEM  i «PlOvj*  COMPUTE  4 t*CU«DL 

1 aa 

1 

4 

4>  ) 

ST  *PT 

3 

4 

0 I 

% 

4 

4 

0 ) 

99  JOVIAL  SIMPLE  TfM  PROGRAM  «» 

5 

4 

0) 

I Tt " 10  m * S 

6 

4 

0) 

1U«  I T f P 1 I 2*  * S 

? 

4 

0 ) 

I T f m 1 UR2  I ?*  S % 

§ 

4 

Cl 

1 Tf  N I T£W|  A M 4 % 

9 

4 

0 ) 

item  i t e ^ & h 4 « 

10 

4 

0 » 

Ov»RiAv  |Tf*i  ■ 1 T 6 0 1 a $ 

1 1 

4 

0 ) 

OVfNtAr  HE*?  « I T£  P?  4 \ 

1? 

4 

U I 

!U*  c apo  * 00  % 

13 

1 

01 

riLt  RCAOfrf  h Q P 04  VlO«l  V(fO*l  TAPES  % 

14 

4 

0 1 

riLt  PWJNTW  » n p 120  ypil  VICO*)  TfP£6  % 

IS 

1 

0 1 

MONITOR  ! 0 « I T £ fc  1 6 , 1 7 f 3 ? A «, 

16 

P 

PwpHM  1 0*1  | f J PBl-V'-  ) » M1|P«PH  r>(jM  ) , 

S ) s 

16 

P 

pppp£  <0m  (C  »*’*<Oo“  It  Ah(£*pP06m  j,  j ) 

s 

16 

P 

MtSSAG  • MSG1  S 

1 7 

4 

0 1 

OUTPUT  PPINTP  M£SSAG  % 

16 

4 

0 I 

bO  • 

tHPyl  PCA^fP  CABO  S 

19 

P 

ICCITh  P£AOPP  MO  V lEO*  > l 

19 

P 

BEGIN 

1 9 

P 

ppo«E  48*'(Eap»OG“  It  0H<fxPHr>6M  !• 

2)  S 

20 

4 

2) 

H f G I S 

?1 

4 

21 

HrT£  (i  c t A *1  ( 10  1 • M V T£  If 

0 t A 

f I 

4 CABp 

) t 

22 

4 

2) 

6VT£  (S  C • * S ) 4 I T F w 1 A ) a RTT£ 

(S  9 

« A 

l)  ( 

CAPO  1 S 

2 3 

4 

?l 

R v T t IS  3 . A SI  ( IT*°?«  ) a RvTE 

4%  19 

t 

AS)  4 

CAPO  ) f 

2* 

4 

21 

Clef'Ll  4 I T£  C 1 , I T£S?  ) \ 

1 

4 

2) 

close  t 

2 

4 

2) 

9$  ^ a i n Close  t* 

3 

4 

31 

BEGIN 

4 

P 

PPQPM  4 pH(£iMP^?  1 • 8m(C*prOGm 

1 t 

1 

) S 

4 

P 

PROBE  (b*ME**pu?  )•  P*i  i * iPPOG**  ), 

1 ) 

S 

4 

P 

IT  E 9 1 * 1 \ 

5 

4 

3) 

I T£  92  . 1 % 

6 

P 

PROP**  4 RH(£jr-PLp  ) , 6w(E*dROGm 

I t 

0 

I S 

6 

P 

End 

2S 

4 

2) 

99  ElNPc?  99 

26 

P 

irciT**  I t c p i gc  ion  s 

26 

P 

BEGIN 

26 

P 

PPQRE  ( 0m  j f i ppogp  it  AHjriPPOG"  it 

A I 

s 

27 

4 

3) 

GOTO  £**-Pl2  * 

?6 

P 

EMO 

Sample  Command  Set 


ALTER  LIBRARY  = REFMAN. 

START , 

JAVSTEXT  = EXPROGM. 

FOR  JAVSTEXT, 

INSTRUMENT . 

END  FOR. 

PUNCH  .JAVSTEXT  ■=  EXPROGM,  INSTRUMENTED  = ALL. 
PRINT, JAVSTEXT  - EXPROGM, INSTRUMENTED  = ALL. 


4 


control 


I/O 
I/O  « 


I MV 


I M V 


PRINT .MODULE . (Cont.) 


H 


Sample  Output 


NODULE  STATEMENT  listing 

MOO  ULf  «F1MP  Ll  >•  JA VST  E X T «E  XPROGM  »•  PARENT  MODULE  «CAP«OOM  > 
MO • LVL  STATEMENT 


oo-paths 
( 1 ) 


CONTROL 


I 

? 

3 

4 

5 

6 
7 
A 
A 

10 
1 l 


?1 

?? 


I 0) 

( 1 > 

( ] ) 

< ) > 

< 1 ’ 

1 1 > 

( ) ) 

( 1 ) 

( 1) 

( 2) 

< n 
I?  ( !l 
13  ( ?) 

; 4 / ?) 

IS  < ?» 
it  ( ?> 

17  1 2) 

18  (?) 
1*  < 3) 
?0  l 3) 

( 3> 

< * ) 
?3  ( 3) 

? 4 ( 4) 

?S  ( 3, 
2b  l 3> 
?7  ( 3) 
?«  < 3> 
?9  ( 3) 

30  I 3) 

31  l a ) 
3?  1 3) 
33  ( 4) 
3%  ( 3) 

35  ( 4 1 

36  < 3) 

37  ( 3) 

38  I 3) 
3*  < 3) 

46  (?) 

41  ( ?> 

4?  i 1 t 
4311) 
44  ( 1 ) 


PROC  fXNPLl  I L1MIT1  % LIMIT?  ) f 
BEGIN 

ITEM  LIMIT1  I ?4  S s 
ITEM  LIMIT?  I ?4  S % 

ARRAY  FILL  loo  1 ?4  s S 

ITEM  RESULT  I ?4  S I 
ITEM  INDXS  I 24  S S 
44.  TRACT  . result  44 
IF  IIMJT1  GO  100  s 
LIMIT]  • 99  S 
RESULT  • 4 \ 

FOR  I ■ 1 • 1 • LIM1T1  S 
BEGIN 

•4.  EXPECT  . RESULT  ■ 1 . 5 44 
FILL  (S  I - 1 SI  ■ I S 
resjlt  • ( result  • 1 ) / I s 

44 • ASSERT  • RESULT  GR  10  tt 
FOP  J ■ 1 • 1 • LIMIT?  S 
BEGIN 
04  CLOSE  44 

IFEITm  J iQ  3 S 
INOXS  • J S 
ORir  I f 

IvDXS  ■ 4 S 

END 

44  IFEITh  4 4 

s»;tch  pick 


( I-  31  IF 

for  3 


FOR3 

4-  %)  IFE1 

6)  ORIF 


( LABELI  • LABEL  1 < LABEL  1 • LABEL?  ) S 


l*bel?. 


GOTO  PICK  (S  INDXS 
60T°  ExmPl3  S 


label) « 


IFEITh  result  LS  4 
MESSAG  ■ MSG?  S 
OR  I F RESULT  EC  4 s 
MESSAG  » MSG3  S 
ORir  1 S 

MESSAG  ■ MS&4  S 
END 

44  IFEITh  44 


END 

44  j 4 4 

END 

44  I 44 
44.  OFFTRACC 
END 


1 s>  s 

1 7- 

1)> 

INV  «• 

( 1?“ 

13) 

I FEW 

< 14- 

IS) 

ORIF 

1 16) 

ORIF 

s 

( 17. 

16) 

I/O 

( 19- 

?0> 

RESULT  44 


Example  Command  Set 


OLD  LIBRARY  = 
START . 

FOR  LIBRARY. 
PRINT, MODULE. 
END  FOR. 

END. 


REFMAN. 
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*\  * i.:  - . ' 

-V-x'  i UEflfal 


I 


J 


PRINT, S3.  PRINT. SB. 


Description 

This  command  produces  a detailed  listing  of  how  the  statements  within 
the  current  module  are  scored  in  the  statement  block  (S3)  on  the  library. 

Each  statement  is  shown  in  token  and  word-pair  form.  The  upper  line  contains 
the  text  of  the  statement  and  the  lower  line  indicates  the  token  classifica- 
tion. This  output  is  intended  for  JAVS  system  maintenance  only. 


Sample  Cutout 


sn'iw'i  >ldc*  l i s t ; ho 


*00l)L£  <C»i*wOOM  »' 

i < I 

t C l PR03M 

> » < 

»A»E  NT 

MOOULE 

<exp»ogm  > 

STATEMENT 

1 

JAVS 

TE*T 

E 

OGM 

COmP 

UTE 

( 

ExCO  mPL  » 

$ A 

OELI  I PC  N 

CONT 

ENOT 

i:en 

ENOT 

I0£n 

ENOT 

DELI 

I0EN  ENOT  OELI 

OELI 

STATEMENT 

2 

STAR  t 

<Eyw  ENOT 

STATEMENT 

3 

* 

OELI 

statement 

A 

tt  JOVI 

AL 

S I *P 

TEST 

PROG 

Ram 

A A 

COMT  COmT 

ENOT 

COMT 

£N0T 

COmT 

ENOT 

COmT 

ENOT 

COMT 

statement 

S 

item 

10 

M 

A 

S 

*Eyw  ENOT 

1 

489R 

DELI 

statement 

6 

Item 

ITER 

1 

I 

2* 

S 

1 

*£y*  ENOT 

2 

ENOT 

488R 

A88R 

DELI 

statement 

7 

item 

ITER 

2 

I 

2* 

S 

S 

*Eyw  ENOT 

3 

ENDT 

A 8 8 R 

A 88R 

OELI 

Example  Command  Set 

OLD  LIBRARY  = REFMAN . 
START . 

JAVSTEXT  = EXPROCM. 
MODULE  = EXPROGM. 
PRINT, SB. 

END. 

I 

j 
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I 

I 

I 


PRINT, SDB 


PRINT, SDB 


Description 

This  command  produces  a detailed  listing  of  the  internal  statement 
descriptors  generated  and  saved  by  JAVS.  This  output  is  intended  for 
researchers  or  sophisticated  JAVS  users  only. 


Sample  Output 

STATEMENT  DESCRIPTOR  LISTING 


■ODULE  «EX»Pl1  >•  JAVSTEAT  «E*PROGM  >,  PARENT  MODULE  TEXPRO&M  > 


NO. 

sr«T 
ci  *ss 

TYPE 

CODE 

Sf  3 SUM 

KO-PPS 

SB 

INDEX 

NO, 

LABELS 

LABEL 

¥0-PPS 

INTEP- 

NTH  PT» 

INTBA* 
NTH  P TP 

COHPLX 

1 

PB0C 

100 

38 

1? 

1 

0 

0 

0 

5 

0 

? 

BE6n 

100 

39 

2 

ES 

0 

0 

0 

0 

0 

3 

i re* 

1 

40 

8 

29 

0 

0 

0 

0 

0 

4 

1 

41 

6 

45 

0 

0 

0 

0 

0 

5 

A99Y 

i 

4 2 

9 

61 

0 

0 

0 

0 

0 

6 

ITCH 

1 

43 

8 

79 

0 

0 

0 

0 

0 

7 

1TE* 

1 

44 

8 

95 

0 

c 

0 

0 

0 

6 

DJfiT 

1 

45 

7 

m 

0 

0 

0 

c 

0 

9 

If 

?Pf 

46 

6 

1 ?s 

0 

0 

11 

0 

0 

10 

A SM7 

100 

47 

5 

133 

0 

0 

0 

3 

c 

11 

A 5**  T 

100 

48 

5 

i»? 

0 

0 

0 

3 

0 

1? 

POP3 

3 00 

49 

10 

153 

0 

0 

41 

0 

0 

13 

BEGN 

100 

SO 

7 

IT? 

0 

0 

0 

0 

0 

U 

DIPT 

1 

SI 

1 1 

161 

0 

0 

0 

0 

c 

IS 

4S“7 

ICC 

s? 

10 

203 

0 

0 

0 

8 

0 

16 

A$*»T 

ICC 

S3 

12 

223 

0 

0 

0 

3 

0 

17 

DIPT 

1 

S 4 

9 

247 

c 

0 

0 

0 

0 

IP 

ro»3 

300 

ss 

10 

265 

0 

0 

39 

0 

0 

10 

BE  ON 

100 

56 

2 

265 

0 

0 

0 

0 

0 

?0 

C0“T 

1 

6? 

4 

289 

0 

0 

0 

0 

0 

?) 

IfLl 

2oc 

63 

6 

ERT 

0 

0 

23 

0 

0 

72 

45»*T 

100 

6 * 

5 

309 

0 

0 

0 

3 

e 

23 

00  If 

sco 

65 

4 

319 

0 

0 

ES 

0 

0 

?4 

*SMT 

IOC 

66 

5 

32> 

0 

0 

0 

3 

0 

?$ 

end 

IOC 

67 

1 

33? 

0 

0 

21 

0 

0 

7b 

COMT 

1 

66 

4 

339 

0 

0 

0 

0 

0 

7 7 

1NS» 

1 

69 

19 

3*7 

0 

0 

0 

4 

0 

28 

GTS« 

100 

TC 

1 1 

385 

0 

0 

?? 

c 

0 

?9 

GTCt 

ICO 

71 

e 

407 

1 

3 

0 

0 

0 

30 

1 r £ I 

200 

7? 

10 

4?3 

1 

3 

3? 

0 

0 

31 

A $*T 

100 

73 

6 

44  3 

0 

0 

0 

3 

0 

3? 

OB]f 

20  C 

74 

7 

455 

0 

0 

34 

0 

0 

33 

A SM7 

100 

75 

6 

469 

0 

0 

0 

3 

e 

34 

0®  I f 

SOL 

76 

4 

461 

c 

0 

36 

0 

c 

35 

45*7 

100 

77 

6 

469 

0 

0 

0 

3 

0 

36 

EnD 

10C 

78 

1 

501 

0 

0 

30 

0 

0 

3T 

C0*T 

1 

79 

4 

503 

0 

0 

0 

0 

0 

38 

0 JTP 

100 

80 

7 

511 

0 

c 

c 

0 

0 

30 

f ND 

400 

61 

1 

s?s 

e 

0 

If 

0 

c 

*0 

COMT 

1 

8? 

3 

527 

0 

0 

0 

0 

c 

M 

t NO 

400 

P 3 

1 

533 

0 

0 

1? 

0 

0 

4? 

C0"7 

1 

64 

3 

535 

0 

0 

0 

0 

0 

*3 

DIRT 

1 

65 

6 

541 

0 

0 

0 

0 

0 

44 

END 

100 

86 

1 

55  7 

0 

0 

0 

0 

0 

Example  Command  Set 

OLD  LIBRARY  = REFMAN . 
START. 

JAVSTEXT  = EXPROGM. 
MODULE  = EXMPL1. 
PRINT, SDB. 

END. 
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PRINT,  SLT 


PRINT, SLT. 
Description 


This  command  produces  a listing  of  the  symbol  locator  table  (SLT)  (i.e., 
a list  of  the  symbols  referenced  within  the  current  module) . This  list  in- 
cludes those  identifiers  and  constants  which  appear  in  the  source  text  which 
are  essential  for  JAVS  processing.  The  first  eight  characters  of  the  symbol 
are  stored  and  pointers  to  other  JAVS-intemal  tables  are  included.  This  out- 
put is  intended  for  JAVS  system  maintenance  only. 

Sample  Cutout 


S1»*OL  LCC i T I DN  TiSLE  listing 

"OOULE  <C1«PL1  >.  J»*STE<T  <E«PP03M  >,  °*S£NT  MOOULE  <EXP«OGM  > 


HO. 

Symbol 

“30ULE 

JAvSTE  XT 

ST0 

F 1 PST 

LAST 

HUM8E9 

1 

EXmp<_  1 

E iPWCGM 

E i P 9 C 3 M 

2 

1 

1 

l 

2 

82 

2 

LI-IM 

E XP90  0* 

-1 

1 

12 

5 

4 

93 

3 

LIMIT? 

E KMPL  1 

E XPPCGM 

-l 

1 

18 

3 

4 

96 

4 

fill 

EXmPL  l 

E *P0C3M 

-5 

5 

15 

2 

4 

99 

5 

130 

E<MPLl 

E IPPCG* 

-5 

5 

5 

1 

4 

103 

6 

aesjur 

£ xmp«_  i 

E <PP03M 

-6 

6 

32 

6 

4 

106 

7 

I 

E XMl>|_  t 

E xpoOjM 

-7 

7 

28 

4 

4 

109 

8 

100 

£ XPOOGM 

E *P9C3M 

*26 

9 

9 

1 

2 

90 

9 

99 

E*mpl  1 

E XPP0  3H 

-10 

10 

10 

1 

4 

112 

1 0 

4 

E * PQO 3*A 

E IPOOjM 

-21 

1 1 

32 

4 

2 

73 

1 1 

1 

E xmPl? 

E *ppo3m 

-4 

12 

34 

6 

3 

87 

12 

3 

E xmpiw  \ 

E KPQCGM 

-21 

21 

21 

1 

4 

120 

13 

PICS 

E *MPL 1 

► IPP03M 

1 

27 

28 

2 

4 

123 

14 

LABEL  1 

E i*?\_  i 

E «O30j“ 

2 

27 

30 

4 

4 

125 

15 

L A8£l2 

E l-PL  l 

E *PP03M 

3 

27 

29 

2 

4 

127 

16 

£ imoL3 

E *mpl  3 

E ipsCjM 

1 

29 

29 

1 

5 

115 

1 7 

"ESSAG 

E *C  3mPL 

£ <C  3m9L 

-11 

31 

38 

4 

l 

15 

18 

MSG? 

F XCCM°L 

El  C3mPi_ 

-8 

31 

31 

1 

1 

6 

19 

MSG  3 

E *CCMPL 

£ <C  3“ °L 

-9 

33 

33 

i 

1 

9 

20 

MSG4 

E iCCmpl 

E *C3*PL 

-10 

35 

35 

i 

1 

12 

?1 

P91 

E *PPOGM 

£ <PO03M 

-14 

38 

38 

i 

2 

55 

Example  Command  Set 


OLD  LIBRARY  = REFMAN . 
START . 

FOR  LIBRARY. 

PRINT,  SLT. 

END  FOR. 

END . 
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PRINT, STB. 


PRINT, STB. 


Description 

This  command  produces  a listing  of  the  detailed,  internal  symbol  table 
(STB)  descriptors  for  each  symbol  defined  in  the  current  module.  Normally  the 
list  includes  only  those  symbols  essential  to  structural  analysis  of  the 
module.  A BASIC  processing  option  causes  all  symbols  defined  in  the  module  to 
be  entered  in  the  STB  (see  BASIC  SYMBOLS  = ON).  The  properties  of  each  symbol 
and  pointers  to  other  JAVS-intemal  tables  are  included.  This  output  is  in- 
tended for  JAVS  system  maintenance  only. 

Sample  Output 

SYMBOL  UBLC  lISMnG 

MODULE  «E 1 mol 1 >•  JiVST£IT  «E IPROGM  >,  PARENT  MODULE  <EIPROGM  > 


MO • SYMBOL 

1 ? 

3 

A 

5 6 

7 

6 

9 

10 

1)  1? 

13 

1A 

15 

16 

17 

16 

19 

20 

22 

23  2A 

27  29  )0 

1 HC* 

2 L OC  » 

INS* 

A 

0 

• 

0 

0 

0 

0 

0 

0 

0 

0 

27 

E*mpli 

13 

2 L ABE  L 1 

1 LOCw 

LA3L 

A 

1 A 

0 

e 

0 

0 

0 

0 

0 

0 

0 

30 

EimplI 

1 A 

3 LABEL? 

1 LOCw 

L A SL 

A 

15 

e 

e 

0 

0 

0 

0 

0 

0 

0 

29 

E *MPL  1 

15 

Example  Command  Set 

OLD  LIBRARY  = REFMAN. 
START. 

FOR  LIBRARY. 

PRINT, STB. 

END  FOR. 

END. 
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This  fora  (PROSE.)  can  be  used  for  a library  containing  only  one  start- 
tern  sequence,  if  the  JAVSTEXT  identif ication  (see  Sec.  l.V)  was  not  used. 
Instrumentation  will  be  performed  using  the  INSTRUMENT  default  options,  and 
the  instrumented  source  text  will  be  written  onto  file  LPUNCH. 

(2)  JAVSTEXT  = <text-name>. 

FOR  JAVSTEXT. 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  = <text  name> , INSTRUMENTED  = ALL. 

This  form  (PROBE, JAVSTEXT  = <text  name>.)  should  be  used  for  instrumen- 
tation of  a specified  JAVSTEXT. 

(3)  JAVSTEXT  = <text  name>. 

FOR  MODULE  = <name- 1> , . . . , <name-n> . 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  = <text  name >, INSTRUMENTED  = <nane- I> , . . . , <name-n> . 

This  form  (PROBE , JAVSTEXT  = <text  name>,  MODULE  = <name-l> . . . . ) should 
be  used  if  only  selected  modules  of  a given  JAVSTEXT  are  to  be  instrumented. 


PROBE.  (Cont.) 


With  all  forms  of  the  PROBE  macro,  the  user  can  specify  automatic  in- 
sertion of  the  PROBI  (test  case  initiation  and  test  termination  data  collec- 
tion routine)  calls  by  preceding  the  PROBE  command  with: 

PROBI , STARTTEST  = <modname>  , < tex  tname>  , < stmt . no . > , { , TESNAM  : ■ , TFLAG  . 

PROBI , STOPTESI  = cmodname’ ,<textname> ,<stmt.  no.>. 


These  commands  are  described  in  Sec.  5 under  their  own  heading.  They 
perform  the  same  function  as  the  INSTRUMENT , STARTTEST  and  INSTRUMENT , STOPTEST 
commands.  The  existence  of  the  PROBI  commands  aids  the  macro  command  processor 
which  will  insert  the  STARTTEST  and  STOPTEST  commands  in  the  generated  series 
of  commands. 


Note 


The  macro  command  processor  will  generate  the  commands: 

OLD  LIBRARY  = TEST. 

START. 


if  the  first  JAYS  command  is  a macro  command  (Rewords  BUILD  LIBRARY , DOCUMENT, 
PROBE, TEST).  The  macro  command  processor  will  generate  the  "END"  command,  if 
it  is  not  present. 


Rules 

(1)  See  INSTRUMENT  constraints  in  Sec.  3.4. 

(2)  Maximum  of  150  modules  selected  in  the  first  two  forms  of  the 
PROBE  macro  command. 

(3;  Maximum  of  23  modules  selected  in  the  third  form  of  the  PROBE 
macro  command. 

(4)  Use  PROBI  (not  INSTRUMENT, STARTTEST  and  STOPTEST)  commands  with 
the  PROBE  macro. 


Example  Command  Sets 

(1)  BUILD  LIBRARY. 

PROBE, JAVSTEXT  = EXPROGM. 

DOCUMENT. 

PRINT,  JAVSTEXT  = EXPROGM,  INSTRUMENTED  ■=  ALL. 

This  command  set  will  create  a new  library,  perform  syntax  and  structural 
analyses,  instrument  the  JAVSTEXT  EXPROGM,  document  an  entire  library,  ana 


PROBE . (Gone.) 


print:  the  instrumented  JAVSTEXT  so  that  the  user  can  see  where  the  PROBI  calls 
should  be  manually  placed. 

G 2)  OLD  LI3RARY  = TEST. 

START. 

PR03I, STARTTEST  = EXPROGM, EXPROCM, 0. 

PR03I , STARTTEST  = EXMP LI, EXPROGM, 9. 

PR03I ,STGPTEST  = EXPROGM, EXPROCM, 0. 

PR03E, JAVSTEXT  = EXPROGM. 

This  command  set  will  instrument  JAVSTEXT  EXPROGM  in  the  existing  lib- 
rary TEST.  In  addition,  the  PRC3I  calls  will  be  automatically  inserted.  The 
first  PROBI, STARTTEST  command  will  cause  an  invocation  to  PROBI  to  be  inserted 
prior  to  the  first  executable  statement  in  module  EXPROGM.  The  second  PROBI, 
STARTTEST  command  will  cause  a PR03I  invocation  to  be  placed  immediately  before 
statement  '9  of  module  EXMPL1.  These  two  PR03I  invocations  will  initiate  a 
new  test  case  whenever  the  PROBI  call  is  executed. 

The  PR03I , STOPTEST  command  will  cause  the  test  termination  PROBI  invoca- 
tion to  be  placed  at  all  exits  from  module  EXPROGM.  The  PR03E  macro  command 
will  instrument  the  JAVSTEXT  EXPR-GM  and  write  the  instrumented  text,  including 
the  invocations  to  PROBI,  onto  file  LPUN’CH. 

.Vote  that  the  library  definition  and  startup  commands  are  included  in 
this  example.  Even  though  the  default  library  name  is  specified,  these  com- 
mands are  required  because  PR03I  is  not  a macro  command. 
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Can  be  used  only  with  the  overlay  version  of  JAVS. 


■r  r'— 
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This  command  per  toms  the  same  function  as: 


INSTRUMENT , 5TOPTEST  » <options>. 

Refer  to  this  heading  for  the  command  description  and  example  command  sets. 

Rules 

(1)  This  command  is  to  be  used  only  in  conjunction  with  the  PROBE 
macro  command  and  must  precede  the  PR03E  command. 

(1)  Only  one  PR03I .STOPTEST  command  with  a single  PROBE  macro  command. 

(3)  Command  options  must  be  given  in  the  order  shown  in  the  command 
description. 

(1)  The  module  specified  in  the  PR03I , STOPTEST  command  must  be  selected 
by  the  PR03E  macro  command. 

(5)  Library  identif ication  and  startup  commands  must  be  included  in  the 
command  set. 


* 

Can  be  used  only  with  the  overlay  version  of  JAVS. 
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PUNCH ,JAVS TEXT  c <name>. 


PUNCH ,JAVSTEXT  « <name>. 


Description 

This  command  produces  on  LPUNCH  in  card  image  format  the  source  state- 
ments for  the  named  START-TERM  text  as  they  were  originally  stored  on  the 
library.  The  file  can  then  be  punched.  The  resulting  cards  are  in  normal 
JOVIAL  format  ready  for  compilation. 

A listing  of  the  cards  resulting  from  this  command  for  text  EXPROGM  is 
shown  in  the  sample  output.  The  statements  are  reformatted  to  a uniform 
structure  with  indentation. 


Rule 


File  LPUNCH  must  be  specified  in  the  job  control  stream. 
Sample  Output  Excerpt 


tt.  JAVSTExT  FXPSOOW  COMPUTE  I £XC0mPl  » tt 
START 

s 

tt  JOVIAL  SIMPLE  TEST  PROGRAM  tt 

I T | M JO  M * S 

ITf«  ITfRj  T S S 

IU*  ITER?  ! ?*  S S 

in**  nisi*  h » s 

ITEM  1 TCR?&  H * S 

OVERLAP  ITr»l  • I TER  1 A S 

OVEhLAv  ITER?  « \ TtR?A  S 

ITEM  CARD  m ec  1 

riLf  READER  M c a ft*  v<0«i  VlEOO  TaRE*.  S 

FILE  PR1NTR  H c 0 l?B  v (O*'  I V (COE  ) TAPEt>  S 

MONITOR  io  . ITCRIA  . IT£R?A  s 
HE  SS AG  • **SG]  $ 

OUTPUT  PR  I N TR  MCSSAG  S 

INPUT  REAOfR  CARD  S 
If  READER  NO  V (EOF ) J 
BEGIN 

BYTE  I*  C • A f)  1 I D ) ■ BYTE  IS  0 . * S>  ( CARD  » s 

BYTE  II  o • * il  ( JTERJA  ) ■ BYTE  (SR  « a Si  ( CARO  ) S 

BYTE  ISO  t a S)  I I T£ R? a ) • BYTE  IS  1 R • a Si  I CARD  ) S 

EXmPwI  I ITCr)  • ITER?  ) S 
CLOSE  ExnRl?  S 
tt  MAIN  CLOSE  tt 
BEG1R 

I TER ] • 1 S 

ITER?  • 1 S 

END 

tt  FYMPl?  tt 

If  ITER]  GO  100  S 
GOTO  EXMPL?  S 


Example  Command  Set 

OLD  LIBRARY  = REFMAN . 
START. 

PUNCH, JAVSTEXT  * EXPROGM. 
END. 
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PUNCH, JAVSTEXT  * <name>. 
INSTRUMENTED  ~ ‘-option* . 


PUNCH.JAVSTEXT  = <nane>, 
ITS  TRIP-RENTED  = <ootion>. 


Description 


This  command  has  two  forms: 

PUNCH, JAVSTEXT  = <text-name>, INSTRUMENTED  = AIL.  or 

PUNCH.JAVSTEXT  = <text-name> , INSTRUMENTED  » <name-I> , <name-Z> , 
<r.ame-n>  . 


•he  command  produces  cn  LPUNCH  in  card  image  format  the  source  state- 
ments for  the  named  START-TERM  text  as  instrumented  by  INSTRUMENT . * The  file 
can  then  be  punched.  The  resulting  cards  are  in  normal  JOVIAL  format  ready 
for  compilation. 

-he  first  form  is  used  when  all  modules  of  the  text  are  punched  with 
instrumentation  inserted.  The  second  form  is  used  when  the  specified  modules 
in  the  text  are  to  have  instrumentation  inserted  and  all  other  modules  in  the 
text  are  not  instrumented.  Any  module  which  has  not  been  processed  by 
INSTRUMENT  will  be  punched  in  uninstrumented , reformatted  form.  The  modules 
must  be  listed  in  the  same  order  in  which  they  appear  on  the  library. 

A listing  of  the  cards  resulting  from  this  command  for  text  EXPROGM  is 
shown  in  the  sample  output.  The  statements  are  reformatted  to  a uniform 
structure  with  indentation. 


Rules 


(1)  Specified  modules  must  be  listed  in  the  same  order  in  which  thev 
appear  in  the  library. 

(2)  File  LPUNCH  must  be  specified  in  the  job  control  stream. 


The  instrumented  text  consists  of  the  source  text  interspersed  with  the  probe 
text  generated  by  INSTRUMENT. 
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**.  JA¥S»IAT  f APWCl'*  CO"'*'  U I f >C  0»*Pl  I •• 
Nl  A..T 


jOviii  si'  i\[  test  p~o'-ram  m 

Ilf  | 1/  M 4 % 

I IF*  I U*ii  | /»♦  s ft 

!»£*■•  IT*ut  I ?t>  s ft 
I T f I T F w , A h 4 % 

I If  ^ I U Wc  A - 4 ft 

r'Vt  -CAT  |ll’l|  s !TfP|l  % 

9vF»M.a  r I I * >•?  ■ I T£p<»a  ft 
I T E M CA->0  rt  HO  ft 

^ I l t pea^cp  - n p «u  v i on » vrtof)  tapes  s 

f 1LI  N|Mw  *•  0 P ^ C O'-  ) V(EOf)  TAPff,  ft 

MONITOR  ! o . ITfPlA  , I T { * 2 & \ 

pwOmm  i a« (f »ppoom  > , hxiliPhCGM  ) # 3 ) ft 

PPO^f  iSmiFippOvjm  It  8*>(E*P*OGm  )•  lit 

-fcSSAG  • "SGI  » 

OUTPUT  PP]NTP  M£  SS AG  ft 

8G. 

Input  HEAuEP  Ca*d  ft 
jfeith  peadf-  no  v c eor i ft 
Hf  UlN 

PWOPE  I8H(£IPP0G**  ).  8M(EAPPOG“  It  P)  ft 
BEGIN 

Hr  Tt  I ft  r t * ft  I ( ID  ) B RvTF.  (ft  P t * ft)  ( CAPD  I ft 

«yTE  (ft  r.  t a ft)  ( I Tf  p I a i * bvTE  (ft  9 t * ft)  ( CAOD  I ft 

b y T £ (ft  •>  . 4 ft)  ( 1 T£  w? a ) * byte  (ft  IP  t * ft)  ( CapD  I ft 

E * MpL 1 » I T £ » 1 , ITE»?  I ft 

CL Osr  F»m pLt  I 
tt  majn  CuOSF  tt 
d£M  n 

PPOtM  ( gHiti-Pt?  ) t bM(E»PPCOM  ) t lift 

PfOnE  l«"lli‘Pi?  )t  BM ( E I PP06M  )#  i)  f 

ITE-1  « 1 ft 

iTE-e  • i ft 

PPOoM  t pM(E<MPL2  I , Bm(£*PROG**  ) • 0 I ft 

END 

tt  f ikp^p  tt 

IFEIT"  ITEPl  IOC  ft 
BEGIN 

PP^oE  r«M(fiPHOGto  )t  BM(fIPROGM  )t  A)  ft 

GCTu  E«“Pl?  ft 

END 

OP  IF  1 ft 

PROoE  (AH (EaPRCG-  It  0m(E*PPOGm  It  S»  f 

END 


i 


Example  Command  Set 

OLD  LIBRARY  = REFMAN. 

START. 

JAVSTEXT  = EXPROGM. 

FOR  JAVSTEXT. 

INSTRUMENT . 

END  FOR. 

PUNCH, JAVSTEXT  «=  EXPROGM, INSTRUMENTED  = ALL. 
END. 
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PUNCH , MODULE . 


PUNCH , MODULE  . 


Description  ' 

This  command  causes  the  module  to  be  vritten  on  L PUNCH  in  card  image 
to rmat.  The  file  can  then  be  punched.  The  resulting  cards  are  in  normal 
JOVIAL  format  ready  for  insertion  in  a text  for  compilation.  If  the  module  is 
the  only  one  in  the  START-TERM  text,  no  additional  manipulation  of  the  punched 
text  Is  necessary,  since  the  START  and  TERM  statements  are  included. 

A listing  of  the  cards  resulting  from  this  command  for  the  module  EXMPL1 
is  shown  in  the  sample  output.  The  statements  are  reformatted  to  a uniform 
structure  with  indentation. 


Rule 


File  LPUNCH  must  be  specified  in  the  job  control  stream. 


Sample  Output 


JAVST£XT  £XP*0G*  COMPUTE  ( £XcO*PL  » 00 

start 

S 

00  JOVIAL  SIMPLE  TESV  PROGRAM  *t 

ITEM  ID  a f 
ITEM  I tE  pi  1 ?♦  s S 
ITEM  ITER?  I ?%  S % 

ITEM  [TERM  M * S 
ITEM  l T E 9 2 4 m 4 S 

overlay  r - r o i » iterm  s 

OVERLAY  MER?  * ITER2A  S 
ITEM  CARO  m SO  * 

FILE  READER  m o R 8*  ViOK)  v EOFj  T APE 5 t 
FILE  PRIVTR  m I)  R 129  V(OK)  V « £ 0 F | TAO£6  S 
MONITOR  ID  . 1TE*M  . I T E®  ? A * 
mESSAG  > -SG)  1 
Output  print*  messag  s 

INPUT  REaOER  CARD  * 

IF  READER  NO  v (£ DF ) S 
BEGIN 

BYTE  <S0  . a Si  (ID)*  BYTE  »S  0 » A S»  < CARO  ) S 

BYTE  is  0 . * S)  ( ITERM  ) m RyTE  ll  4 • Ml  ( CARD  I S 

BYTE  (S  0 . * t)  ( ITER2A  ) * BYTE  ll  l«  . t (I  l CARO  > 1 

EXMPui  ( 1 7£  9 1 . ITER?  » S 

00  EXMPL?  «* 

IF  I T£  R l GO  100  S 
GOTO  E*mPL2  S 
GOTO  85  I 
ENO 

00  IF  00 
STOP  S 
00  EXMPL1  00 
TERM  s 


Example  Cor.nand  Set 

OLD  LI3RARY  = REFMAN. 
START. 

FOR  LI3RARY. 

PUNCH, MODULE. 

END  FOR. 

END . 
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STRUCTURAL. 


STRUCTURAL . 


Description 

The  STRUCTURAL  command  with  the  print  option  at  its  default  value  pro- 
duces the  report  output  shown  in  the  sample  output.  The  actions  performed  bv 
the  STRUCTURAL  command  are : 

1.  To  build  tables  describing  the  graphical  characteristics  of  the 
specified  module  and  add  them  to  a library 

2.  To  produce  the  report  shown  in  the  sample  output 

Rule 


See  STRUCTURAL  constraints  in  Sec.  3.3. 


Sample  Output 

JOVIAL  AUTOMATED  VERIFICATION  SYSTEM  SECONDARY  MO^ulE  ANALYSIS  *»» 

MODULE  EXMPL1  > OF  JAVSTEXT  <EXPROGm  >. 

MODULE  DEPENDENCE  TABLE  CONSTRUCTED. 

STATEMENT  descriptor  BLOCKS  UPDATED. 

00-PATh  TARLE  CONTAINS  ?0  ENTRIES. 


Example  Command  Set 


ALTER  LIBRARY  = REFMAN. 
START. 

JAVSTEXT  = EXPROGM. 

FOR  JAVSTEXT. 

STRUCTURAL . 

EOT  FOR. 

END. 
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STRUCTURAL , PRIST  = <option>. 


STRUCTURAL, PRINT  = <option>. 


Rescript  ion 


STRUCTURAL, PRINT  = SUMMARY /DEBUG . (DEFAULT  » SUMMARY . ) 

This  command  allows  user  control  over  the  amount  of  information  printed 
in  the  report  produced  during  STRUCTURAL  processing.  Debug  output  which  is 
useful  to  JAVS  maintenance  activities  is  generated  with  the  command: 

STRUCTURAL, PRINT  = DE3UG . 

Example  Command  Sec 

ALTER  LI3RARY  = REFMAN . 

START. 

FOR  LI3RARY . 

STRUCTURAL, PRINT  = DE3UC. 

STRUCTURAL . 

END  FOR. 

END. 
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TEST. 


TEST. 


* 


* 


Description 


The  TEST  macro  command  has  two  forms : 

(1)  TEST. 

(2)  TEST, MODULE  = <name-l> , <name-2> , . . . , <name-n> . 

The  TEST  macro  command  generates  a series  of  JAVS  ANALYZER  commands  for  post- 
test analysis. 

The  expansion  of  the  two  forms  of  TEST  is  as  follows: 

(1)  ANALYZER, ALL  MODULES. 

ANALYZER, SUMMARY . 

ANALYZER, NOTH IT. 

ANALYZER, MODTRACE. 

ANALYZER. 

. 

(2)  ANALYZER, MODULE  = <name-l> , . . . ,<name-n> . 

ANALYZER, SUMMARY. 

ANALYZER, NOTHIT. 

ANALYZER , MODTRACE . 

ANALYZER. 

Additional  post-test  analysis  reports  can  be  produced  by  preceding  the 
TEST  macro  with  ANALYZER  process  option  commands.  In  this  case,  library  iden- 
tification and  startup  commands  must  be  included  in  the  command  set. 

Note 

The  macro  command  processor  will  generate  the  commands: 

OLD  LIBRARY  = TEST. 

START. 

if  the  first  JAVS  command  is  a macro  command  (keywords  BUILD  LIBRARY , DOCUMENT, 

PROBE, TEST).  The  macro  command  processor  will  generate  the  "END"  command,  if 
it  is  not  present. 

Rules 

(1)  The  ANALYZER, DDPTRACE  standard  command  cannot  be  used  in  conjunction 
with  the  TEST  macro. 


* 

Can  be  used  only  with  the  overlay  version  of  JAVS. 


»»  *'  * * ' 

i ii  i li  i MittTrfriillfcl 


J 
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TEST.  (Cone.) 

(2)  ANALYZER  option  connands  muse  precede  the  TaST  nacro,  if  they 
are  uaed. 

t.3>  See  ANALYZER  constraints  in  Sec.  3.3. 

Exar.pLe  Ce™ar.d  Sets 

Cl)  ZEST. 

FOR  LI3RARY . 

PRINT, OOP. 

END  FOR. 

(Z)  OLD  LIBRARY  = REFMAN. 

ANALYZER,. NODLST. 

ANALY  '.ZR,  DDP.ATHS . 

TEST .N.CDL'LE  - EXPROGM, EXMPL1. 
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App . A 


The  JOVIAL  keywords  recognized  by  JAVS  are: 


A3S 

LQ 

.ALL 

LS 

AND 

HAN'T 

ARRAY 

MODE 

ASSIGN 

MONITOR  (2,3) 

3EGIN 

NENT 

3IT 

NOT 

3YTE 

NQ 

CHAR 

NWDSEN 

CLOSE 

ODD 

COMMON 

OPEN 

COMPOOL  (1) 

OR 

DEFINE 

ORIF 

DIRECT 

OUT  (1) 

END 

OUTPUT 

ENT 

OVERLAY 

ENTRY 

POS 

EQ 

PROC 

FALSE  (1) 

PROGRAM 

FILE 

REM 

FOR 

REMQUO 

GOTO 

RETURN 

GQ 

SHUT 

GR 

START 

IF 

STOP 

IFEITH 

STRING 

IN  (1) 

SWITCH 

INPUT 

TABLE 

10  (1) 

TERM 

ITEM 

TEST 

JOVIAL 

TRUE  (1) 

LOC 

WAIT  (1) 

NOTES:  (1)  Honeywell  JOVIAL  keyword;  (2)  CDC  JOVIAL  keyword;  (3)  JOCIT 

JOVIAL  keyword. 
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B.l  UNIVERSAL  COMMAND  ERROR  MESSAGES 


Error  Message 

Library  opened  read/write 
with  improper  password 

No  information  on  read  only 
library 

Procedure  invoked  with  module 
equal  to  zero 

Too  many  error  messages 
No  JAVSTEXT  specified 


Corrective  Act  Ion 

Library  name  for  .ALTER  library 
must  be  cr.e  same  as  when  created. 
Change  library  name  and  rerun. 

Provide  already  created  library 
permfile  or  remove  old  library 
command. 

Specify  a module  on  the  library 
and  rerun. 

Make  correction  for  preceding 
error  messages  and  rerun. 

Specify  JAVSTEXT  and  rerun. 
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B . 2 BASIC  ERROR  MESSAGES 


w 


The  error  messages*  resulting  from  BASIC  source  code  analysis  are: 

Error 

Number  Explanation 

0 The  first  symbol  in  the  JOVIAL  source  program  is  not  a START 
or  a CLOSE.  A START  is  assumed  and  processing  continues. 

1 A single  prime  which  is  not  a legal  symbol  in  a JOVIAL  source 
program  has  been  encountered.  The  prime  is  ignored. 

2 The  constant  has  an  illegal  format.  The  resulting  constant 
may  not  compile. 

3 A comment  is  terminated  by  a dollar  sign.  The  first  symbol 
following  the  dollar  sign  is  considered  to  be  the  beginning 
of  the  next  statement  or  declaration. 

4 The  define  information  overflows  one  of  the  tables  provided 
for  it.  As  a result,  this  define  directive  and  all  subsequent 
define  directives  may  be  ignored. 

5 The  preset  data  constant  conflicts  with  the  definition  of  the 
item  with  which  it  is  associated.  The  constant  is  processed 
as  if  it  were  legal. 

6 The  symbol  encountered  in  a preset  data  list  or  as  a single 
preset  data  constant  is  neither  a constant  nor  an  END.  If 
the  illegal  symbol  occurs  as  the  first  constant  in  a list  or 
in  the  place  of  a single  preset  data  constant,  the  symbol  is 
changed  to  the  constant  zero.  If  the  illegal  symbol  occurs 
within  a preset  data  list,  it  is  ignored.  If  the  next  symbol 
in  the  list  is  a constant  or  an  END,  the  processing  of  the 
preset  data  list  is  continued.  If  not,  the  processing  is 
discontinued  and  the  next  symbol  is  considered  to  be  part  of 
the  next  statement  or  declaration. 

7 An  illegal  character  has  been  found  in  the  JOVIAL  source  pro- 
gram. The  character  is  treated  as  a blank. 

8 An  end-of-file  has  been  encountered  on  the  input  device,  but 
no  TERM  $ has  been  found.  A TERM  $ is  assumed  and  processing 
continues . 

10  The  symbol  which  begins  the  statement  or  declaration  is  not 

legal  at  the  beginning  of  a statement  or  declaration.  The 
JOVIAL  source  program  is  scanned  until  a symbol  legal  at  the 
beginning  of  a statement  or  declaration  is  encountered. 

I 


Error 

Number 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
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Ex? lanatlon 

A statement  or  a declaration  which  is  not  legal  within  a table 
declaration  has  been  encountered.  The  processing  of  the  table 
is  terminated.  If  chere  are  no  other  declarations  for  the 
table,  it  is  removed  from  the  dictionary.*  Then  the  current 
statement  or  declaration  is  processed  normally. 

An  E-  or  A-factor  for  a constant  contains  more  than  the  number 
of  numerals  allowed  for  it.  The  number  is  truncated  on  the 
left. 

The  name  is  missing  from  a close,  program,  or  switch  declara- 
tion. The  declaration  is  ignored. 

A simple  item  has  been  defined  by  a status  constant.  An  in- 
complete definition  for  the  item  is  left  in  the  dictionary. 

A name  other  than  a sequence  designator,  simple  item,  or 
procedure  has  been  used  without  being  previously  declared. 

This  error  message  is  printed  only  when  no  COMPOOL  has  been 
specified.  The  name  is  entered  in  the  dictionary  with  the 
standard  mode  definition,  unless  it  is  a table  name. 

There  is  a syntax  error  in  the  switch  declaration.  The  rest 
of  the  declaration  is  ignored. 

The  name  appearing  in  an  OPEN  or  SHUT  is  not  a FILE  name. 

The  FILE  name  does  not  appear  in  the  proper  place  in  an  I/O 
statement . 

A constant  is  succeeded  by  a loop  variable,  abbreviation, 
primitive  or  name  with  no  intervening  blanks.  A blank  is 
assumed . 

A procedure  declaration  has  been  encountered  within  another 
procedure  declaration.  The  previous  procedure  is  terminated. 

There  is  a syntax  error  in  the  heading  of  a procedure  declara- 
tion. The  rest  of  the  symbols  up  to  the  first  dollar  sign  are 
ignored . 


makes  use  of  an  internal  dictionary  from  which  JAVS  tables  are  built. 


Explanation 


A constant  has  been  found  in  a subordinate  overlay  declaration 
(overlay  declaration  within  a table  declaration).  The  rest  of 
the  overlay  declaration  is  ignored. 

A syntax  error  has  been  found  in  an  overlay  declaration.  The 
rest  of  the  statement  is  ignored. 

The  external  file  name  is  not  a constant  or  a symbol. 

A syntax  error  has  been  found  in  a define  directive.  The  rest 
of  the  directive  is  ignored. 

The  name  is  missing  from  a simple  item,  table  item,  or  array 
declaration.  The  rest  of  the  declaration  is  ignored. 

A STRING  statement  appears  outside  a TABLE  statement  sequence. 

The  dimension  information  for  an  array  overflows  the  dimension 
table.  The  rest  of  the  array  declaration  is  ignored. 

Two  contiguous  symbols  in  the  statement  are  not  legal  placed 
next  to  one  another.  The  left  symbol  has  been  ignored. 

A possible  missing  dollar  sign  has  been  detected.  A dollar  sign 
has  been  inserted,  the  statement  counter  incremented,  and  the 
processing  of  the  JOVIAL  source  program  is  continued. 

A symbol  has  been  detected  as  illegal  inside  of  the  current 
level  of  bracketers  (parentheses,  brackets,  exponentiation 
brackets,  or  absolute  value  brackets).  The  statement  is 
processed  as  though  no  error  were  found. 

A constant  followed  by  an  equals  sign  has  been  encountered 
outside  of  procedure  parentheses  or  switch  parentheses. 

For  example: 

IF  10  = AA  $ 

A period  followed  by  a right  parenthesis  has  been  encountered 
outside  of  a 'LOC  or  procedure  parentheses,  or  a period  fol- 
lowed by  a comma  or  an  equals  sign  has  been  encountered 
outside  of  procedure  parentheses.  If  a name  preceded  the 
period,  it  has  been  treated  like  a statement  name.  For 
example : 

AA  - AA- (CC+DD . ) $ 


B-5 


Number 


Exp  lanation 

When  che  end  of  the  statement  was  reached,  the  count  of 
bracketers  in  the  statement  had  not  reached  zero.  That  is, 
there  were  more  left  bracketers  than  right  bracketers  in  the 
statement . 

A right  bracketer  does  not  match  the  appropriate  left  bracketer. 
Error  messages  nay  be  printed  for  the  remaining  right  bracketers 
in  the  statement. 

Bracketers  in  the  statement  are  nested  more  than  24  deep. 

The  processing  of  the  statement  has  been  terminated  and  the 
statement  counter  incremented. 

A dollar  sign  has  been  recognized  as  the  left  term  in  a pair 
of  symbols.  This  dollar  sign  is  illegal  but  it  is  assumed 
that  it  terminates  the  statement.  The  statement  counter  is 
incremented . 

The  accumulator  designator  "A("  has  been  encountered  outside 
of  a direct  statement.  It  is  processed  as  if  there  were  no 


The  entity  being  declared  has  the  same  name  as  a previously 
declared  entity  with  overlapping  scope  and  domain.  The  de- 
claration is  processed  as  though  no  error  has  occurred. 

The  entity  being  declared  has  the  same  name  as  a previously 
used  entity  with  overlapping  scope  and  domain.  The  declaration 
is  processed  as  though  no  error  has  occurred. 

A status  constant  has  been  used  incorrectly  in  the  statement. 
This  may  result  in  the  integer  constant  0 being  substituted 
for  the  status  constant. 

The  table  containing  the  names  of  COMPOOL-def ined  status  vari- 
ables ''as  overflowed.  That  is,  too  many  COMPOOL-def ined  status 
variables  are  being  used  with  a total  of  too  many  constants. 
Subsequent  usage  of  new  variables  or  old  variables  used  with 
new  constants  will  elicit  this  same  error  message  and  will  not 
be  handled  correctly. 

The  symbol  following  the  FOR  in  a FOR-clause  is  not  a loop 
variable.  The  clause  is  processed  normally. 

The  dictionary  has  overflowed.  That  is,  the  JOVIAL  source 
program  contains  too  many  constants  and  names.  Processing 
of  the  program  has  been  terminated. 
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Explanation 


a.  A name  that  is  not  a sequence  designator  i6  being  declared, 
and  is  found  to  be  the  same  as  a name  that  is  already  in 
the  dictionary. 

or 

b.  A name  is  being  used  in  a way  that  is  inconsistent  with 
its  existing  dictionary  definition.  The  name  is  assumed 
to  be  the  same  as  the  one  in  the  dictionary. 

A global  simple  item  has  the  same  name  as  a procedure.  The 
simple  item  is  processed  as  though  no  error  has  occurred. 

No  dimension  information  has  been  given  for  an  array  encountered. 
The  preset  data  are  ignored. 

More  than  three  levels  of  preset  data  for  an  array  declaration. 
The  rest  of  the  declaration  is  processed  normally. 

The  preset  data  list  for  an  array  does  not  have  the  same  number 
of  dimensions  as  the  array.  The  preset  data  have  been  ignored. 

The  count  of  BEGIN-END's  for  the  preset  data  for  an  array 
or  string  is  incorrect  since  a symbol  illegal  within  a preset 
data  list  has  been  encountered.  The  processing  of  the  preset 
data  list  is  termir.ated. 

There  is  a syntax  error  in  a table  declaration.  The  rest  of 
the  declaration  is  processed  in  as  normal  a manner  as  possible. 

The  number  of  like  tables  exceeds  26. 

A syntax  error  has  been  encountered  in  a simple  item,  table 
item,  or  array  declaration.  The  processing  of  the  declaration 
is  terminated. 

The  status  list  is  missing  from  a status  item  declaration. 

The  rest  of  the  declaration  is  processed  normally. 

A table  item  declaration  does  not  have  the  correct  format  for 
a def ined-entry  table.  The  information  in  the  dictionary 
for  the  table  item  will  be  incorrect. 

The  overlay  information  overflows  the  overlay  table.  The 
rest  of  this  overlay  declaration  is  ignored. 
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Error 

Number 


60 


62 


64 


65 


66 


67 


63 


70 


71 


73 


74 


75 


Ex? lanatlon 

A JOVIAL  primitive  which  is  not  implemented  in  the  JAVS  dia- 
lect has  been  encountered.  (See  Appendix  A.)  The  primitive 
is  ignored. 

A subsequent  constant  in  a preset  data  list  is  not  compatible 
with  the  initial  constant  in  the  list.  The  constant  is 
processed  normally. 

No  dollar  sign  was  found  at  the  end  of  a statement.  A dollar 
sign  was  assumed,  however. 

No  dollar  sign  was  found  at  the  end  of  a declaration.  A 
dollar  sign  was  assumed. 

A TERM  or  end-of-file  on  the  input  device  was  encountered 
within  a table  declaration.  Processing  of  the  JOVIAL  source 
program  is  discontinued. 

A TERM  or  end-of-file  on  the  input  device  was  encountered 
within  a procedure.  ENDs  are  added  for  the  procedure.  Then 
the  processing  of  the  JOVIAL  source  program  is  discontinued. 

The  3EGIN-END  count  for  the  main  program  was  not  zero  when 
the  TERM  or  end-of-file  on  the  input  device  was  encountered. 
ENDs  are  added  for  the  main  program.  Then  the  processing  of 
the  JOVIAL  source  program  is  discontinued. 

A name  or  a constant  overflows  the  number  of  characters 
allowed  for  it  (120  is  the  maximum  number  of  characters 
allowed  by  most  compilers).  The  excess  characters  have  been 
deleted  from  the  name  or  constant. 

There  are  too  many  characters  in  the  names  and  constants 
used  by  the  JOVIAL  source  program.  Processing  of  the  JOVIAL 
source  program  is  discontinued. 

The  number  of  preset  data  constants  in  a list  is  greater  than 
the  maximum  number  of  entries  in  the  table.  The  excess  number 
of  constants  has  been  deleted  from  the  list. 

A preset  data  constant  (P  followed  by  a constant)  was  found 
in  an  array  or  table  item  declaration.  The  constant  was 
processed  normally. 

An  illegal  double  period  has  been  encountered.  A double  period 
is  legal  only  when  there  are  two  consecutive  floating  constants 
(example:  2.. 2 which  is  the  same  as  2.  .2).  The  second  period 

is  processed  like  a numeral. 
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rror 

umber 


76 


77 

78 
RO 


81 


82 


83 


84 


85 


86 

87 


Explanation 

A status  constant  was  not  found  in  the  status  list,  for  the 
status  variable  with  which  it  is  associated.  The  value  of 
the  constant  is  set  to  zero. 

The  statement  begins  with  a dollar  sign,  and  the  statement 
counter  is  incremented  by  one. 

A table  declaration  with  no  items  has  been  encountered.  The 
table  is  removed  from  the  dictionary. 

A local  simple  item  has  the  same  name  as  the  procedure  in 
which  it  is  being  used.  This  item  has  no  local  declaration, 
but  it  is  assumed  that  it  defines  the  procedure  as  a function. 

A local  procedure  call  references  a procedure  with  the  same 
name  as  the  procedure  in  which  it  is  being  used.  This  is  a 
recursive  use  of  the  procedure  name.  The  two  procedure  names 
are  assumed  to  refer  to  the  same  entity  in  the  dictionary. 

A name  used  in  an  overlay  declaration  or  as  an  actual  input 
or  output  parameters  for  a procedure  has  the  same  name  as  a 
table  item.  The  two  variables  are  assumed  to  have  the  same 
entry  in  the  dictionary. 

A name  not  identified  as  to  class  (i.e.,  may  be  a simple  item, 
table  item,  etc.)  has  the  same  name  as  a procedure  with  over- 
lapping scope.  The  variable  is  processed  as  though  no  error 
has  occurred. 

A table  item  or  table  has  the  same  name  as  a procedure  with 
overlapping  scope.  The  table  item  or  table  is  processed  as 
though  no  error  has  occurred. 

A local  table  or  array  has  the  same  name  as  the  procedure  in 
which  it  is  declared.  The  table  or  array  is  processed  as 
though  no  error  has  occurred. 

A procedure  has  the  same  name  as  another  global  variable.  The 
procedure  name  is  processed  as  though  no  error  has  occurred. 

A FILE  name  matches  a PROC  name. 


88  An  impossible  entry  in  the  variable  or  label  identification 

matrix  has  been  encountered.  This  indicates  either  a compiler 
or  machine  error. 
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Error 

Number 

92 

94 

95 

97 

98 

99 

351 

353 

900 

901 

941 

950 

984 

985 

986 

983 

990 


Explanation 

There  is  a preset  data  constant  for  a formal  input  or  output 
parameter  for  a procedure.  The  preset  data  constant  i3 
ignored . 

There  are  too  many  rows  in  the  preset  data  list  for  an  array. 

The  excess  columns  have  been  deleted. 

There  are  too  many  planes  in  the  preset  data  list  for  an  array. 
All  of  the  rest  of  the  preset  data  for  the  array  is  ignored. 

The  preset  data  for  a string  statement  is  too  long. 

A BEGIN  is  missing  in  preset  data. 

A procedure  has  been  used  inconsistently.  It  has  been  declared 
and/or  used  both  as  a procedure  and  a function.  The  final 
dictionary  definition  -will  reflect  the  way  in  which  the  procedure 
was  declared. 

More  than  3000  names  and  constants  appear  in  JOVIAL  source 
being  processed.  Program  must  be  broken  down  for  BASIC 
analysis . 

A JAVSTEXT  directive  does  not  correspond  to  text  type. 

A token  has  been  misclassified  in  3ASIC  internal  processing. 

More  than  53  nested  modules  appear  in  JOVIAL  source  stream. 

The  program  must  be  broken  down  for  BASIC  analysis. 

Module  is  not  a program,  procedure,  close,  C0MP00L,  or  JAVSTEXT. 

A CLOSE  statement  occurs  in  an  illegal  context. 

More  than  250  word  pairs  appear  in  token.  The  token  is  omitted 
from  SB. 

A COMMON  statement  not  terminated  with  $.  A $ is  assumed. 

An  illegal  comment  in  the  same  form  as  a JAVS  directive  has 
been  encountered.  The  token  is  not  entered  in  the  SB  table. 

More  than  100  names  appear  in  the  statement.  The  statement 
must  be  broken  down  for  BASIC  processing. 

The  statement  has  an  unrecognizable  class  value. 


*****  • qgjtt 
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997  Input  parameter  error. 


999  An  unknown  entry  type  has  been  encountered  in  the  internal 

dictionary. 
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STRUCTURAL  ERROR  MESSAGES 


Error 

Message 

3ad  stacemenC  type  on  stack 

BEGIN-END  block  contains  no 
statement 

Duplicate  symbol  which  is  not  a 
local  label 

END  does  not  natch  3ECIN,  IFEITH  or 
FOR 

External  array  has  overflowed 

External  switch  call  treated  as 
return 

FOR  statement  not  in  stack 
FOR  target  pointer  error 
FOR  variable  not  found  in  S3 

GOTO  label  not  found 

Illegal  statement  type  on  stack 

Invalid  statement  in  IFEITH/ORIF 

Invalid  token  type  in  switch 
declaration 

JOVIAL  statement  missing 
Module  number  <-  0 


Corrective 

C ^ ^ 0 T 

Check  syntax  of  module.  Rerun  3ASIC 
and  STRUCTURAL 

Informational  message  only 

Duplicate  symbol  in  ST3  treated  as  a 
global  label.  No  rerun  necessary 

Check  syntax  of  module.  Rerun  3ASIC 
and  STRUCTURAL 

Reduce  number  of  externals  to  less  than 
ICO.  Rerun  3ASIC  and  STRUCTURAL 

Declare  switch  in  module  and  rerun 
3ASIC  and  STRUCTURAL 

Rerun  STRUCTURAL 

Rerun  3A5IC  and  STRUCTURAL 

Check  syntax  of  FOR  statement.  Rerun 
3 ASIC  and  STRUCTURAL 

Check  syntax  of  GOTO  statement  and  re- 
run BASIC  and  STRUCTURAL  on  module 

Rerun  STRUCTURAL 

Rerun  BASIC  and  STRUCTURAL 

Check  syntax  of  switch  declaration  and 
rerun  3ASIC  and  STRUCTURAL 

Check  syntax  of  module  for  DIRECT- 
JOVIAL  statements.  Rerun  BASIC  and 
STRUCTURAL 

Specify  a module  on  the  library.  Rerun 
STRUCTURAL 


Error 

Message 

Nested  switch  call  treated  as  fall 
through  case 

Never  found  PROC  statement 
Pointer  LQ  0 

Possible  infinite  loop  detected 

Stack  overflow 

Stack  underflow 
Switch  name  missing 

Test  stack  overflow 
Too  many  paths  begin  at  statement 
Too  many  statements  on  DD-path 
Undefined  GOTO 


Corrective 
Action 

Replace  switch  invocation  in  switch 
declaration  by  a label  and  rerun  BASIC 
and  STRUCTURAL 

JOVIAL  procedure  must  contain  PROC 
statement.  Rerun  BASIC  and  STRUCTURAL 

Rerun  STRUCTURAL 

Rewrite  module  to  remove  infinite  loop. 
Rerun  BASIC  and  STRUCTURAL 

Increase  the  stack  size  bv  recompiling 

STRUCTURAL.  Rerun  STRUCTURAL. 

Rerun  BASIC  and  STRUCTURAL 

Check  SWITCH  syntax  and  rerun  BASIC  and 
STRUCTURAL 

Increase  the  size  of  the  test  stack  by 
recompiling  STRUCTURAL,  Rerun 
STRUCTURAL 

Increase  the  size  of  the  DD-path  queue 
by  recompiling  STRUCTURAL.  Rerun 
STRUCTURAL 

Increase  the  size  of  the  DD-path  state- 
ment list  by  recompiling  STRUCTURAL. 
Rerun  STRUCTURAL 

Check  location  of  label  referenced  in 
GOTO.  Rerun  BASIC  and  STRUCTURAL 
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NATIONAL  BUREAU  OF  STANDARDS 

MICROCOPY  RESOLUTION  TEST  CHART 
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INSTRUMENT  ERROR  MESSAGES 


Error 

Message 

3ad  nodule  number 

3EGIN-END  block  contains  no 
statements 

Could  not  natch  parentheses 
Delimiter  stack  overflow 

Directive  not  recognized 

External  switch  call  not 
instrumented 

GOTO  label  not  found 

Input  string  too  long — truncated 
from  head 

Invalid  statement  type  in  chain 

Invalid  switch  type 

Last  statement  in  module  is  not 
TERM  or  END 

No  DD-path  for  statement 

Number  of  switch  labels  <=  0 

ORIF  statement  number  not  on  false 
branch  stack 

Pointer  out  of  range 


Corrective 

Action 

Specify  a module  number  within  the 
library.  Rerun  INSTRUMENT 

Informative  message 


Check  syntax  of  statement.  Rerun 
BASIC,  STRUCTURAL,  and  INSTRUMENT 

Increase  the  size  of  the  delimiter 
stack  by  recompiling  INSTRUMENT.  Re- 
run INSTRUMENT . 

Check  syntax  of  directive.  Rerun 
3ASIC , STRUCTURAL  and  INSTRUMENT 

Declare  switch  in  module.  Rerun  BASIC, 
STRUCTURAL,  and  INSTRUMENT 

Check  syntax  of  GOTO  statement.  Rerun 
BASIC , STRUCTURAL,  and  INSTRUMENT 

Change  size  of  internal  buffers  by 
recompiling  INSTRUMENT.  Rerun 
INSTRUMENT 

Check  syntax  of  IFEITH  statement.  Re- 
run BASIC,  STRUCTURAL,  and  INSTRUMENT 

Check  syntax  of  switch  declaration. 
Rerun  BASIC,  STRUCTURAL,  and  INSTRUMENT 

Add  a TERM  or  END  statement  to  the 
module  and  rerun  BASIC,  STRUCTURAL  and 
INSTRUMENT 

Rerun  STRUCTURAL  and  INSTRUMENT 
Rerun  STRUCTURAL  and  INSTRUMENT 
Rerun  INSTRUMENT 


Rerun  STRUCTURAL  and  INSTRUMENT 
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Error 

Message 

Stack  overflow 
Stack  underflow 

String  longer  than  text  buffer 

Unable  to  recognize  type  of  FOR 
statement 

Variable  not  declared  in  preceding 
TRACE  directive 


Corrective 

Action 

Increase  the  stack  size  by  recompiling 
INSTRUMENT . Rerun  INSTRUMENT 

Rerun  INSTRUMENT 

Increase  the  size  of  the  text  buffer  by 
recompiling  INSTRUMENT.  Rerun 
INSTRUMENT 

Check  syntax  of  FOR  statement.  Rerun 
BASIC,  STRUCTURAL,  and  INSTRUMENT 

Declare  variable  in  TRACE  directive. 
Rerun  INSTRUMENT 
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3.5  ASSIST  ERROR  MESSAGES 

Error 

.Message 

Beginning  DDP  outside  range  of  DD- 
paths 

Target  DDP  outside  range  of  DD-paths 
Too  many  DD-paths 

Too  many  DD-paths  in  reaching  set 

Too  many  essential  predicates 


Corrective 

Action 

Incorrect  command.  Rerun  ASSIST 


Incorrect  command.  Rerun  ASSIST 

Select  smaller  reaching  set.  Rerun 
ASSIST 

Select  smaller  reaching  set.  Rerun 
ASSIST 

Select  smaller  reaching  set.  Rerun 
ASSIST 
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DEPENDENCE  ERROR  MESSAGES 


Corrective 

Action 


Error 

Message 

Too  many  called  modules  from  group 

Too  many  calling  modules  to  group 

Too  many  outside  modules  called  from 
library 


Select  smaller  group.  Rerun  DEPENDENCE 

Select  smaller  group.  Rerun  DEPENDENCE 

Select  group  off  library.  Rerun 
DEPENDENCE 


% 
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3.7  ANALYZER  ERROR  MESSAGES 


Error  Corrective 

Mes sage  Action 


Illegal  record  on  AUDIT  file  Check  AUDIT  file  for  IH(TERM)  in  last  record. 

If  not  present,  test  execution  did  not  invoke 
the  test  termination  PROBI  module. 

Unknown  module  specified  Specify  only  those  modules  on  the  library. 

Rerun  ANALYZER. 

3ad  module  value  Check  AUDIT  file  for  4H(TERM)  in  last  record. 

If  not  present,  test  execution  did  not  invoke 
the  test  termination  PROBI  module.  Check 
for  use  of  previously  written  AUDIT  file. 
Insert  test  termination  PR03I  call  in  instru- 
mented code  where  it  will  be  invoked  during 
test. 
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B.8  OTHER  JAVS  SYSTEM  ERRORS* 


i 


i 


I 


i 


Error 

Message 

ACTMOD  does  not  know  an  active  module  is 
Bad  call  to  PUTBIT 
Bad  module  value 

Beginning  block  of  search  is  out  of  table  range 

Block  does  not  exist  for  table 

Changed  module  not  yet  on  new  library 

Did  not  know  module  was  active 

Entry  point  tables  for  both  libraries  are  empty 

Fragment  beyond  range 

Fragment  number  given  as  zero 

GETLST  called  for  non-variable  length  table 

Illegal  block  number 

Illegal  core  address 

Illegal  core  fragment  number 

Illegal  library  address 

Illegal  library  fragment  number 

Illegal  library  number 

Illegal  table  number 

Improper  call  to  PREPT 

Index  beyond  block  size 

*The  error  messages  listed  in  this  section  are  for  internal  JAVS  errors  indi- 
cative of  flaws  in  JAVS  software  over  which  the  user  has  no  control. 
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Error 

Message 


IRSTAB  cannot  be  used  with  variable  length  table 
Library  opened  with  improper  fragment  size 
LSETUP  bad  record  length 

MD3GET  can  only  be  used  with  active  modules 
MDB  not  on  library 

Module  location  table  has  been  overflowed 

Module  must  be  active  to  change 

Module  not  in  core  to  dump 

Module  number  not  yet  assigned 

Module  outside  legal  range 

Mo  more  table  space  available 

Mo  such  block 

Mo  such  fragment 

Mot  yet  implemented 

PUTLST  called  for  non-variable  length  table 
Selected  block  out  of  known  range 
Selected  block  out  of  table  bounds 
Table  not  known  in  system 
Too  many  items  in  variable  list 
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App.  C 


Abbreviation 

Meaning 

Abbreviation 

Meaning 

ARRY 

ARRAY 

INPT 

INPUT 

; 

ASMT 

ASSIGNMENT 

INSW 

INDEX  SWITCH  DECLARATION 

ASSN 

ASSIGN 

INV 

PROCEDURE  INVOCATION 

ASSY 

ASSEM3LY  CODE 

ITEM 

ITEM 

i 

BEGN 

3EGIN 

ITSW 

ITEM  SWITCH  DECLARATION 

CLOS 

CLOSE 

JOVL 

JOVIAL 

CCMN 

COMMON 

LA3L 

LABEL 

COMT 

COMMENT 

MODE 

MODE 

CONT 

CONTINUATION 

MNTR 

MONITOR 

CMPL 

CCMPOOL 

OPEN 

OPEN 

DEFN 

DEFINE 

ORIF 

ORIF 

DIRC 

DIRECT 

OUT 

OUT 

DIRT 

JAVS  DIRECTIVE 

OUTF 

OUTPUT 

END 

END 

OVRL 

OVERLAY 

EXCH 

EXCHANGE 

PROB 

INSTRUMENTATION  PROBE 

[ i 

FILE 

FILE 

PROC 

PROCEDURE 

FORI 

1 FACTOR  FOR  CLAUSE 

PROG 

PROGRAM 

! 

FOR2 

2 FACTOR  FOR  CLAUSE 

PRST 

PRESET  LIST 

FOR3 

3 FACTOR  FOR  CLAUSE 

RETN 

RETURN 

[ i 

FUNC 

FUNCTION 

SHUT 

SHUT 

GOTO 

GOTO  LABEL 

STRG 

STRING 

GTCL 

GOTO  CLOSE 

STRT 

START 

: 

GTSW 

GOTO  SWITCH 

STOP 

STOP 

1 

GTEX 

GOTO  EXTERNAL  LABEL 

SWTC 

SWITCH 

(RETURN) 

TABL 

TABLE 

[ t 
L( 

IF 

IF 

TBLI 

TABLE  ITEM 

10 

10 

TERM 

TERM 

|i 

IFEI 

IFEITH 

TEST 

TEST 

1} 

IN 

IN 

WAIT 

WAIT 

INDEX 


Actual  parameters 


Report 

5-54 

ANALYZER 

Constraints 

3-9 

Coverage 

2-19 

Function 

1-2,  2-1 

Option  commands 

4-11,  4-12 

Processing 

2-20 

Purpose 

2-19 

Tracing 

2-19 

ASSERT  directive 

1-11 

ASSIST 

Constraints 

3-6 

Function 

1-2,  2-1 

Processing 

2-9 

AUDIT  file 

1-4,  2-13 

Declaration 

2-14 

BASIC 

Constraints 

3-3 

Function 

1-2,  2-1 

Option  commands 

4-10 

Processing 

2-2 

Card  image  listing 

5-36 

Code  expansion 

2-18 

Commands 

4-1, 

5-1 

Command  language 

1-5, 

1-6 

Keywords 

4-2 

Library 

4-1 

Module  selection 

4-1, 

4-8,  4-9 

Overlay  commands 

5-3, 

5-4 

Print/punch 

4-3, 

4-15 

Process  execution 

4-3, 

4-10,  4-13 

Process  option 

4-1 

Startup 

4-1, 

4-7 

Termination 

5-3, 

5-4 

Universal 

1-5 

Comments  (in  source  text) 

5-37 

COMPOOL 

Data  Collection  routines  compool 

2-14 

Identification 

1-10 

Processing 

5-41 

1-1 


index  (co^t.) 


Computation  directives 
I as  c rumen  t3 1 ion 
Performance  data 

Cons  traints 
ANALYZER 
ASSIST 
3 AS  LC 

DEPENDENCE 
INSTRUMENT 
STRUCTURAL 
Test  Execution 
Universal 

Coverage  (.Test) 

DD-path 
3 tatement 

Cross  reference 

Database  library 
Definition 
Utilization 

Data  collection 
Routines 

PROBI 

Data  flow  analysis 
ASSERT  directive 
EXPECT  directive 
OFFTRACE  directive 
TRACE  directive 

DD-path 

Definition 

Example 

DEPENDENCE 

Function 

DEFINE  variables 

DOCUMENT 

Error  messages 

Example  program 


1-11,  2-8 
5-70 
2-11 


3-9 

3-6 

3-3 

3-8 

3-5 

3-4 

3-7 

3-2 


5-10 

5-15 

5-24 


1- 4 

2- 1 


2-11,  2-13,  5-72,  5-73, 

5-74 

2-13 


1-11 

1-11 

1-12 

1-12,  1-13 


2-4 

2- 5,  2-6 

1-2,  2-1 

5-38 

5-59 

3- 1 

1-7,  1-8 


1-2 


INDEX  - (Cont.) 


Execution  time 

5-22 

EXPECT  directive 

1-12 

Files 

Identification 

1-4 

Formal  parameters 

Report 

5-54 

INSTRUMENT 

Code  expansion 

2-18 

Constraints 

3-5 

Directive  instrumentation 

2-S,  2-11 

Function 

1-2 

Option  commands 

4-11 

Processing 

2-7 

Structural  instrumentation 

2-8 

Inter-module  dependencies 

2-10,  5-46,  5-48 

JAVS  overlay 

1-4,  1-5,  1-6,  2' 

JAVSTEXT 

Directives 

1-10 

Identification 

1-10 

Listing 

5-88,  5-90 

Selection 

5-56,  5-78 

JOVIAL  keywords 

A-l , A- 2 

Library 

Commands 

4-4,  4-5,  4-6 

Definition 

1-4 

LIBNEW 

1-4,  2-2,  4-4,  5' 

LIBOLD 

1- 4,  2-3,  2-9,  2' 

2- 19,  4-4,  5-82 

Macro  commands 

4- 2,  4-3,  5-43, 

5- 98,  5-109 

Merging  libraries 

5-79 

Module 

Definition 

1-10,  2-2 

Example 

1-7,  1-8 

Listing 

5-92 

Selection 

5-81 

OFFTRACE  directive 

1-12 

1-3 


IMOF.X  (Cone.) 


Overview 

1-3 

PROBD 

2-15 

Probes 

2-7 

PR03I 

2-13,  2-15 

PR03I 

2-15 

Automatic  insertion 

5-75,  5-76 

Example 

2-17 

Program  flow 

2-4 

P i '.tare 

5-26 

Program  documentation 

DOCUMENT 

5-60 

Punch 

F ile 

1-4,  2-13, 

Javstext 

5-103,  5-1 

Module 

5-106 

Reaching  set 

5-29 

Retesting  guidance 

2-10 

Source  text  processing 

2-2 

Statement  type  abbreviations 

C-l 

START-TERM 

Selection  command 

4-8 

Breakdown  into  modules 

->_2 

Text  identif ication 

1-10 

STRUCTURAL 

Constraints 

3-4 

Function 

1-2,  2-1 

Option  command 

4-10,  4-11 

Process ing 

2-3 

SymboL  table 

5-40,  5-97 

Test  assistance 

2-9 

Test  case 

initiation 

2-15 

Termination 

2-15 

1-4 


INDEX  (Cont.) 


Test  description 
PROBD 


2-15 


Test  execution 
Compilation 
Input/Output 
Loading 
Processing 
Purpose 


1-2 

2-13,  2-16 
2-18 
2-18 
2-12 
2-11 


Time  (execution) 


5-22 


TRACE  directive 


1-12,  1-13 


Tracing 

DD-paths 

Modules 


5-12 

5-17 


Tree 


5-57 


Universal 

Commands 

Constraints 


1-5 

3-2 


Wrapup 


4-16,  5-62 


1-5 
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metric  system 


BASE  UNITS: 

Quantity 


Unit 


length 

metre 

mass 

kilogram 

time 

second 

electric  current 

ampere 

thermodynamic  temperature 

kelvin 

amount  of  substance 

mole 

luminous  intensity 

candela 

SUPPLEMENTARY  UNITS 

plane  angle 

radian 

solid  angle 

steradian 

DERIVED  UMTS: 

Acceleration 

metre  per  second  squared 

activity  ( of  a radioactive  source) 

disintegration  per  second 

angular  acceleration 

radian  per  second  squared 

angular  velocity 

radian  per  second 

area 

square  metre 

density 

kilogram  per  cubic  metre 

electric  capacitance 

farad 

electrical  conductance 

siemens 

electric  Field  strength 

volt  per  metre 

electric  inductance 

henry 

electric  potential  difference 

volt 

electnc  resistance 

ohm 

electromotive  force 

volt 

energy 

loule 

entropy 

loule  per  kelvin 

force 

newton 

frequency 

hertz 

illuminance 

lux 

luminance 

candela  per  square  metre 

luminous  flu* 

lumen 

magnetic  field  strength 

ampere  per  metre 

magnetic  flux 

weber 

magnetic  flu*  density 

tesla 

magnetomotive  force 

ampere 

power 

watt 

pressure 

pascal 

quantity  of  electricity 

coulomb 

quantity  of  heat 

louie 

radiant  intensity 

watt  per  steradian 

specific  heat 

loule  per  kilogram-kelvin 

stress 

pas:  al 

thermal  conductivity 

watt  per  metre-kelvin 

velocity 

metre  per  second 

viscosity,  dynamic 

pascal-second 

viscosity,  kinematic 

square  metre  per  second 

voltage 

volt 

volume 

cubic  metre 

wavenumber 

reciprocal  metre 

work 

loule 

SI  PREFIXES 

Multiplication  Factors 

i ooo  ooo  ooo  ooo  = in” 

1 000  OOO  000  = 10" 

1 000  OOO  = 10“ 

i ooo  - iu’ 

100  * 10' 

10  * 10’ 

0 1 = 10-' 
001  * 1 0- 1 
0 001  * 10- ’ 
o ooo  ooi  * io-‘ 

0 OOO  OOO  001  * 10*  • 
0 OOO  OOO  OOO  001  * 10-  ” 

0 OOO  000  OOO  otto  001  - 10-" 

o ooo  ooo  ooo  ooo  ooo  ooi  =-  in-  '• 

* To  be  avoidad  where  possible 


SI  Symbol  Formula 


m 

kg 


A 

h 


mol 

cd 

rad 

sr 

ms 

(disintegration):* 
rad  s 
rads 
m 

kg  m 

F 

A-S.Y 

S 

AV 
V m 

H 

V-s.  A 

V 

\y  a 
V A 

V 

W A 

1 

N-m 

IV 

N 

kg-m.s 

Hz 

(cyclels 

1* 

Invm 

cdm 

lm 

cd-sr 

Am 

Wb 

V-s 

T 

Wtvm 

A 

V> 

I-s 

Pa 

N m 

C 

As 

1 

N-m 
VV  sr 
)kg.k 

Pa 

N m 
W m-k 
rrvs 
Pb-s 

m s 

V 

1 

W A 
m 

(wave)'m 

N*m 

Prefix  SI  Symbol 


tera 

gig* 

mega 

kilo 

hecto" 

deka* 

decl" 

centt* 

mllll 

micro 

nano 

pico 

femtn 

atto 


T 

c; 

M 

k 

h 

da 

d 

c 

m 

M 

n 

r 
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MISSION 

of 

Rome  Air  Development  Center 


RADC  plans  and  conducts  research,  exploratory  and  advanced 
development  programs  in  command,  control,  and  communications 
(C3)  activities,  and  in  the  C3  areas  of  information  sciences 
and  Intelligence.  The  principal  technical  mission  areas 
are  coammications , electromagnetic  guidance  and  control, 
surveillance  of  ground  and  aerospace  objects,  intelligence 
data  collection  and  handling,  information  system  technology, 
ionospheric  propagation,  solid  state  sciences,  micromave 
physics  and  electronic  reliability,  smlntainabllity  and 
cceipatibility . 
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